Skip to main content
Searches a linked merchant for products by keyword. For DoorDash, select a store first with buy_select_store, or the search falls back to the nearest grocery store.
Not advertised in tools/list by default — the buy tool covers this conversationally. Expert integrations can still call it by name.

​
Parameters

ParameterTypeRequiredDescription
merchantstringYesThe linked merchant slug.
querystringYesThe keyword to search for.

​
Returns

Up to 25 matching products, each with its name, brand, price, and size, plus the ids you need next: the product id for buy_add_to_cart, and an msid when present. If nothing matches, it returns “No products found.”

​
Example

{ "name": "buy_search_products", "arguments": { "merchant": "goodeggs", "query": "oat milk" } }