# Search products

Find products from shopping needs, keywords, a model or a product identifier.

## How it helps

Find products that fit what you need, whether you have a broad shopping question, a particular model in mind or a product link. Tell your agent your budget and must-have features, and distinguish them from preferences you are willing to compromise on.

## Ask your agent

Once gaisho is connected, ask in your own words. For example:

Ask your agent

```
Find me a cordless vacuum under $300 for a small apartment with a cat.
```

Ask your agent

```
Find over-ear noise-cancelling headphones under $200 with at least 30 hours of battery life. Black would be nice, but isn’t essential.
```

Ask your agent

```
Find this model and show me the available options: Sony WH-1000XM5.
```

## What you’ll get

You get a shortlist with product names, available prices, sellers and purchase links, together with an explanation of how the options fit your requirements.

Some products may not provide enough detail to confirm a feature. Your agent can distinguish those from confirmed matches and investigate further. If there are many options, it can help you narrow them down; if there are none, you can decide which requirements to change.

## Continue shopping

- [Get product details](https://gaisho.co/docs/mcp/get_product): Read product specifications, ratings, reviews and offers, for one product or up to eight at once.
- [Get offer details](https://gaisho.co/docs/mcp/get_offer): Read a listing’s purchase URL, seller, price, coupon terms and stated product information.
- [Compare purchase options](https://gaisho.co/docs/mcp/find_deals): Find offers for the same product, compatible alternatives, or models with specification upgrades and downgrades.

## Connection and reference

- [Connect your agent](https://gaisho.co/docs/mcp#skill): Add gaisho and start asking shopping questions.
- [API reference](https://gaisho.co/docs/api/search_products): For developers: parameters, request examples and response fields.
