# Amazon Best-Sellers Rankings API

> Amazon Best-Sellers Rankings API is a paid API for AI agents from agent.apiguru.app, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-01).

Returns current Amazon best-seller rankings for any category or subcategory, including rank, ASIN, title, price, and rating, paginated across 20 country marketplaces.

## Facts

- Endpoint: GET https://agent.apiguru.app/agent/v1/v2/best-sellers?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/amazon-best-sellers-rankings-api-3b9a3ac5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_isBo0SEfh3jjLuhE49jSh

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability amazon-best-sellers-rankings-api-3b9a3ac5
```

Example prompt: Pull the current Amazon best-seller rankings for the Kitchen & Dining category in the US marketplace, first page — I want each product's rank, ASIN, title, price, and rating so I can spot trending items to source.

## When to prefer this

Choose this endpoint when you need structured, ranked product lists for a specific Amazon category or subcategory across multiple country marketplaces. It is ideal for trend detection, competitive research, and product sourcing workflows where knowing exact rank, ASIN, price, and rating matters. Prefer this over a general Amazon product search when you specifically want category-level ranking data rather than keyword-driven results.

## Known failure modes

- Invalid or unrecognized category/subcategory returns an empty list or error
- Unsupported country marketplace code results in a validation error
- Rate limiting or payment failure (x402) if USDC balance is insufficient
- Stale or temporarily unavailable Amazon data may return cached or partial results
- Pagination beyond the last available page returns an empty result set

## How this service works

Current Amazon best-seller rankings for any category or subcategory, with rank, ASIN, title, price and rating for each entry. Paginated and available across 20 country marketplaces. Useful for trend detection, category research and product sourcing.

## Output

A paginated list of best-selling products for the requested Amazon category and marketplace, each entry containing the bestseller rank, ASIN, product title, current price, and star rating. Results span up to 20 country marketplaces and can be paginated to retrieve additional entries beyond the first page.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "geo": {
       "enum": [
        "US",
        "CA",
        "DE",
        "MX",
        "UK",
        "FR",
        "IT",
        "ES",
        "AU",
        "BR",
        "IN",
        "JP",
        "NL",
        "AE",
        "PL",
        "SA",
        "SG",
        "SE",
        "TR",
        "BE",
        "IE",
        "ZA",
        "EG"
       ],
       "type": "string",
       "default": "US"
      },
      "page": {
       "type": "integer",
       "default": 1,
       "maximum": 5,
       "minimum": 1
      },
      "category": {
       "type": "string",
       "default": "appliances"
      },
      "subcategory_code": {
       "type": "string"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/amazon-best-sellers-rankings-api-3b9a3ac5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent.apiguru.app](https://www.zero.xyz/host/agent.apiguru.app/llms.txt)