# Apiguru Amazon Data API

> Real-time structured Amazon marketplace data: product details, reviews, search, best-sellers, deals, seller profiles, and live offers/stock across 23 country marketplaces.

Callable by AI agents with **no account, no API key and no subscription**: **3 free calls** per client per 24h, then pay per call ($0.003 and up) in USDC (native USDC on each network; on Base 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) over x402 -- or use an Apiguru account.

## Try it

```bash
curl 'https://agent.apiguru.app/agent/v1/v2/product-details/B09DJLW458/US'
```

No headers, no signup. Put the required value in the path (several agent fetchers drop query strings); an Amazon product URL works in place of an ASIN. Every answer is JSON and starts with `_links` to the next useful call.

## Working URLs you can fetch right now

- https://agent.apiguru.app/agent/v1/v2/product-details/B09DJLW458/US
- https://agent.apiguru.app/agent/v1/v2/product-reviews/B09DJLW458/US
- https://agent.apiguru.app/agent/v1/search/wireless+headphones/US
- https://agent.apiguru.app/agent/v1/product/B09DJLW458,B0014C0LUC/US
- https://agent.apiguru.app/agent/v1/stock/B09DJLW458,B0014C0LUC/US
- https://agent.apiguru.app/agent/v1/v2/best-sellers?geo=US
- https://agent.apiguru.app/agent/v1/v2/deals?geo=US
- https://agent.apiguru.app/agent/v1/seller-profile/A2A1RNLLUK3HYA/US
- https://agent.apiguru.app/agent/v1/v2/seller-products/A2A1RNLLUK3HYA/US
- https://agent.apiguru.app/agent/v1/v2/seller-reviews/A2A1RNLLUK3HYA/US

## What each call answers

- `/v2/product-details` (product_details): Full product detail for a single ASIN. $0.003 per call.
- `/v2/product-reviews` (product_reviews): Customer reviews for a single ASIN. $0.003 per call.
- `/search` (search): Search Amazon products by keyword. $0.003 per call.
- `/product` (product_details_batch): Product detail for up to 20 ASINs in one call. $0.0024 per item (max 20).
- `/stock` (offers_stock): Live offers and inventory for up to 10 ASINs. $0.0045 per item (max 10).
- `/v2/best-sellers` (best_sellers): Best-seller rankings for a category. $0.003 per call.
- `/v2/deals` (deals): Current Amazon deals with filters. $0.003 per call.
- `/seller-profile` (seller_profile_batch): Seller profiles for up to 10 seller IDs. $0.0036 per item (max 10).
- `/v2/seller-products` (seller_products): Products listed by a seller. $0.003 per call.
- `/v2/seller-reviews` (seller_reviews): Feedback reviews for a seller. $0.003 per call.

## Ways in

- **MCP** (Claude, ChatGPT, Cursor, Codex, ...): `https://mcp.apiguru.app/mcp`, keyless. When the free calls run out a tool returns an x402 PaymentRequired result that an x402-capable MCP client pays in-band (`_meta["x402/payment"]`). To bill an Apiguru account instead, connect `https://mcp.apiguru.app/account` and sign in.
- **HTTP, no account**: the URLs above. After the free calls, a 402 carries an x402 challenge (`PAYMENT-REQUIRED` header) that any x402 client pays and retries.
- **HTTP, with an API key**: the same URLs with the header `X-API-KEY` (never in the query string).
- **Machine-readable**: OpenAPI https://dash.apiguru.app/openapi.json; prices and schemas, free: `https://agent.apiguru.app/.well-known/x402`.

## Cost, keys and consent

- Calls cost money after the free ones. Do not pay, or use a user's API key, without the user's consent; agree a budget and set a spend cap in your x402 client. One call costs at most $0.05.
- An API key goes only in the `X-API-KEY` header: never in a URL, a log, a file, or back to the user.
- Every error is JSON with `http_status`, `billed`, `retryable` and `next_step`; retry only when `retryable` is true. A 404 (not on that marketplace) is billed; 400s and 5xx are not; a 402 means pay, send a key, or sign in.
- A timeout on an API key or with a payment attached may still have been billed: do not repeat it automatically, ask first. Answers are fetched live from Amazon; allow 60 s.
- Prefer the batch endpoints over loops: cheaper per item.
- Only `agent.apiguru.app`, `mcp.apiguru.app` and `dash.apiguru.app` are involved; none of them redirects elsewhere.

## More

- Full guide: https://agent.apiguru.app/llms-full.txt -- paying step by step in Python and TypeScript, clients that lose query strings or only follow seen URLs, reading large answers, what Amazon's own data gets wrong, every error code.
- Found something wrong? `POST https://dash.apiguru.app/api/v1/feedback` with `{"message": "..."}` -- free, no key -- or https://github.com/apiguru-app/agent-kit/issues. The wall is public: send only what the user agreed to, never keys or personal data.