{"uid":"cap_CTpERlobjN4v3MFEOlQff","slug":"asin402-amazon-best-sellers-list-48383d5c","name":"ASIN402 Amazon Best Sellers List","description":"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.","url":"https://asin402.com/api/data/bestsellers?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}}}},"responseSchema":{"type":"json","example":{"_meta":{"cached":false,"price_paid":"$0.007","marketplace_domain_id":1},"asins":["B0F3GWXLTS","0735211299"],"total":2,"category":"3375251"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.007","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.007/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ybf2H6EUNKquRkOzgZYgV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.007","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Competitor product landscape analysis","prompt":"Give me the top 500 ASINs in Amazon's Electronics category ranked by their 30-day average sales rank on the US marketplace — I want to see what's been consistently selling well recently."},{"title":"Historical holiday season best sellers","prompt":"What were the best-selling ASINs in the Amazon Toys category in December 2023 on the US marketplace? Give me up to 1000 results."},{"title":"UK marketplace category research","prompt":"Get me the top 300 best sellers in Amazon UK's Sports & Outdoors category right now using current sales rank, including all product variations."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:39:33.814Z","isFirstParty":false,"canonicalSlug":"asin402-amazon-best-sellers-list-48383d5c"}