> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# buy_search_products

> Search a linked merchant for products by keyword

Searches a linked merchant for products by keyword. For DoorDash, select a store first with [buy\_select\_store](/companies/mcp/tools/buy_select_store), or the search falls back to the nearest grocery store.

<Note>Not advertised in `tools/list` by default — the [buy](/companies/mcp/tools/buy) tool covers this conversationally. Expert integrations can still call it by name.</Note>

## Parameters

| Parameter  | Type   | Required | Description                |
| ---------- | ------ | -------- | -------------------------- |
| `merchant` | string | Yes      | The linked merchant slug.  |
| `query`    | string | Yes      | The 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](/companies/mcp/tools/buy_add_to_cart), and an `msid` when present. If nothing matches, it returns "No products found."

## Example

```json theme={null}
{ "name": "buy_search_products", "arguments": { "merchant": "goodeggs", "query": "oat milk" } }
```