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."
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.