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

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

Returns

object[]
Up to 5 matching products.

Example

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.