# ASIN402 Amazon Best Sellers List

> ASIN402 Amazon Best Sellers List is a paid API for AI agents from asin402.com, paid per call via x402, $0.007/call, status unknown (last checked 2026-10-31).

Returns an ordered list of Amazon ASINs ranked by sales in any category, supporting current rank, 30/90/180-day average, or historical monthly rank, for up to 500,000 ASINs.

## Facts

- Endpoint: GET https://asin402.com/api/data/bestsellers?utm_source=zero.xyz
- Price: $0.007/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/asin402-amazon-best-sellers-list-48383d5c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CTpERlobjN4v3MFEOlQff

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 asin402-amazon-best-sellers-list-48383d5c
```

Example prompt: Pull me the top 200 best-selling ASINs in Amazon's Beauty category on the US marketplace, ranked by their 90-day average sales rank.

## When to prefer this

Use this endpoint when you need Amazon best-seller rankings that go far deeper than the public top-100 page — ideal for product research, catalog analysis, or competitive intelligence across any Amazon marketplace. It is especially valuable when you need historical monthly rankings or multi-day average ranks (30/90/180-day) rather than just a snapshot of current rank. Prefer this over general Amazon search endpoints when the goal is to retrieve a ranked popularity list for an entire category rather than matching specific keywords.

## Known failure modes

- No list exists for the requested category/date combination — endpoint returns no charge and an empty or null result
- Invalid category node ID — returns an error or empty list
- Unsupported marketplace domain — returns validation error
- Invalid month/year combination (outside 36-month historical window) — returns error
- Exceeding allowed limit values — may return validation error or default behavior

## How this service works

Amazon best sellers list for any category, current or historical. Ordered ASIN list of best sellers in a category (up to 500,000 for root categories, 10,000 for sub-categories), ranked by current sales rank, by 30/90/180-day average rank, or for a past month. Deeper than the public Best Sellers page (top 100). Not charged if no list exists.

## Output

A JSON object containing an array of ASIN strings ordered by the requested rank metric, the total count of ASINs in the list, the resolved category ID, and metadata including whether the result was cached, the price paid, and the marketplace domain ID. Returns up to 500,000 ASINs for root categories and 10,000 for sub-categories.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "category"
     ],
     "properties": {
      "year": {
       "type": "integer",
       "description": "4-digit year, with month."
      },
      "limit": {
       "type": "integer",
       "description": "Return only the top N ASINs (does not change cost). Default 1000."
      },
      "month": {
       "type": "integer",
       "description": "1-12, with year: monthly average rank for a past month (last 36 months)."
      },
      "range": {
       "enum": [
        0,
        30,
        90,
        180
       ],
       "type": "integer",
       "description": "0 = current rank (default), or 30/90/180-day average rank."
      },
      "domain": {
       "type": "string",
       "description": "Amazon marketplace: us, uk, de, fr, jp, ca, it, es, in, mx, br. Default us."
      },
      "sublist": {
       "enum": [
        0,
        1
       ],
       "type": "integer",
       "description": "1 = rank by sub-category instead of main category."
      },
      "category": {
       "type": "string",
       "description": "Category node ID, or a product group name such as Beauty. Find IDs with /api/data/category-search."
      },
      "variations": {
       "enum": [
        0,
        1
       ],
       "type": "integer",
       "description": "1 = all variations, 0 = one per parent (default)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "_meta": {
       "type": "object",
       "properties": {
        "cached": {
         "type": "boolean"
        },
        "price_paid": {
         "type": "string"
        },
        "marketplace_domain_id": {
         "type": "integer"
        }
       }
      },
      "asins": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "total": {
       "type": "integer"
      },
      "category": {
       "type": "string"
      }
     
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "_meta": {
   "cached": false,
   "price_paid": "$0.007",
   "marketplace_domain_id": 1
  },
  "asins": [
   "B0F3GWXLTS",
   "0735211299"
  ],
  "total": 2,
  "category": "3375251"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/asin402-amazon-best-sellers-list-48383d5c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from asin402.com](https://www.zero.xyz/host/asin402.com/llms.txt)