---
title: "Product search API for AI agents"
url: https://www.datawebot.com/search
description: "Search products for sale by keyword, on one shop or across shops, in any country. Title, price, shop, rating, review count, image and a product_id for each. 5 credits a search; failed or empty searches are free."
author: datawebot team
---

Product · Search

# Search any shop for products.

Ask for products by keyword, on one shop or across shops, in any country and language. Each result comes back as a product: title, price, shop, rating and a product_id for the next step. Up to 5 credits a search; failed or empty searches are free.

[Connect your agent](https://www.datawebot.com/docs/agents) · [See pricing](https://www.datawebot.com/pricing)

What you ask

## A keyword. A shop if you want one.

In an agent, just ask: “find running shoes under $100 at US shops”. The agent calls `search_products` with these inputs.

| Input | What it does |
| --- | --- |
| `query` | What to look for, in any language: "running shoes", "ワイヤレスイヤホン". |
| `site` | Optional. One shop, as a domain (amazon.de) or a name. Leave it out to search across shops. |
| `country` | Two-letter market code, US by default. Picks the shop's market when site is a name. |
| `limit` | Up to 20 products, 10 by default. |
| `format` | structured (common product fields) or raw (also the shop's own JSON, where it has one). |
| `max_credits` | Optional budget. If the search could cost more, nothing runs and nothing is charged. |

What comes back

## Products, not pages.

A real search for “Sony WH-1000XM5 headphones” across US shops, read on 27 October 2026 at 05:37 UTC.

search_products · US · across shops 5 of 5 shown

| Title | Shop | Price | Rating |
| --- | --- | --- | --- |
| Sony WH-1000XM5 Wireless Noise Canceling Headphones | Best Buy | $228.00 | 4.6 (15,000) |
| Sony WH-1000XM5 Noise-Canceling Wireless Over-Ear Headphones 30 Hours Playback Time | Target | $189.99 | 3.5 (11) |
| Sony WH-1000XM5 Noise-Canceling Wireless Over-Ear Headphones | Lowe's | $281.99 | 4.6 (15,000) |
| Sony Wh-1000xm5 … (Sold without manufacturer warranty) | Walmart - Daily Spirit Deals | $272.95 | 4.6 (15,000) |
| Sony WH-1000XM5 Wireless Noise-Canceling Headphones Black | Lowe's | $299.00 | 4.6 (15,000) |

Prices are what each shop showed at that time. They are a dated snapshot, not current prices.

| Field | What it holds |
| --- | --- |
| `title` | The listing's title |
| `price` | Amount, currency and the shop's own wording |
| `original_price` | The price before a discount, when the shop shows one |
| `shop` | Which shop sells it |
| `rating, review_count` | When the shop shows them |
| `image_url, url` | The product image and the page, when the result has them |
| `availability` | In stock or not, when the shop says |
| `product_id` | Pass it to get_product for details and every seller's price |

Where to use it

## From your agent or your own code.

The same search through the MCP server or the REST API, with the same answer.

MCP

### In your agent

Give your agent the setup prompt. It signs you in by email and gets `search_products`.

Give this to your agent

```
set up https://mcp.datawebot.com/setup.md
```

[MCP server](https://www.datawebot.com/mcp)

API

### In your code

Send the same search over REST with an API key from the dashboard.

POST /v1/requests

```
curl https://api.datawebot.com/v1/requests \
  -H "Authorization: Bearer $DATAWEBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"capability":"search","query":"running shoes","country":"US","limit":10}'
```

[REST API](https://www.datawebot.com/api)

FAQ

## A few useful answers.

Does it search one shop or many?

Either. Set site to search one shop, or leave it out to search across shops in the country you choose.

Which countries and languages?

Any country with a two-letter code. Search in the shop's own language: local-language searches return local listings. Coverage differs by country and product.

Are the prices live?

Each result is what the shop showed when it was read, and every answer says when (meta.as_of). Prices change, so treat a result as a dated snapshot, not a verified current price.

What does a search cost?

Up to 5 credits a search, whatever the number of results. Failed or empty searches are free. Every account starts with 200 free credits. Before anything runs, check_site gives a shop's price.