Skip to main content
Permission: Read · Workspace: not required (global catalog) Searches Goody’s product catalog and returns up to 5 candidate products. There’s no pagination — to refine, call again with tighter filters. This is the discovery half of the gifting flow. Most results are fixed-price SKUs. Some are a Gift of Choice (price_type variable, is_flex_gift true): the recipient picks from a curated set and the sender funds any amount within [price_min, price_max]. To list Gifts of Choice directly, use goody_gift_of_choice_list.

​
Parameters

​
query
string
Free-text intent — recipient interests, vibe, or occasion (e.g. “tea lover”, “Vermont maple syrup”). Matched across product name, description, and brand.
​
price_min
integer
Minimum price, in cents (e.g. 2500 for $25). Strings are accepted and coerced.
​
price_max
integer
Maximum price, in cents.
​
exclude_alcohol
boolean
default:"true"
Defaults to true. Set false only if the user explicitly asked for alcohol gifts.
​
shipping_tier
string
default:"domestic_us"
One of domestic_us (default), international (recipient outside the US), or any.
​
category_id
string
UUID of a Goody category. Advanced — usually omitted.

​
Returns

​
products
object[]
Up to 5 matching products.

​
Example

"Find a thank-you gift under $50 for a client who loves coffee."

{
  "name": "goody_products_search",
  "arguments": { "query": "coffee gift for a client", "price_max": 5000 }
}

{
  "products": [
    {
      "id": "0f3c…",
      "name": "Cold Brew Starter Kit",
      "brand": "Grady's",
      "image_key": "products/cold-brew-starter-kit.png",
      "price_cents": 4200,
      "price_type": "fixed",
      "is_flex_gift": false,
      "price_min": null,
      "price_max": null,
      "alcohol": false
    },
    {
      "id": "9a17…",
      "name": "Single-Origin Coffee Trio",
      "brand": "Driftaway Coffee",
      "image_key": "products/coffee-trio.png",
      "price_cents": 3600,
      "price_type": "fixed",
      "is_flex_gift": false,
      "price_min": null,
      "price_max": null,
      "alcohol": false
    }
  ]
}
Pair with goody_products_get for richer detail before committing, or goody_gift_of_choice_list when the recipient’s taste is unknown — let them pick.