{"uid":"cap_nscjI-Yw2z7HvypS7RsQH","slug":"api-direct-amazon-best-sellers-rankings-9f8bb14d","name":"API Direct – Amazon Best Sellers Rankings","description":"Get Amazon best-seller rankings for a category — Best Sellers, New Releases, Movers & Shakers, Most Wished For, or Gift Ideas.","url":"https://x402.apidirect.io/v1/amazon/best-sellers?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["category"],"properties":{"page":{"type":"integer","default":1,"maximum":2,"minimum":1,"description":"Page number, 1 or 2 (default: 1). Rankings cover the top 100."},"type":{"enum":["best_sellers","gift_ideas","most_wished_for","movers_and_shakers","new_releases"],"type":"string","default":"best_sellers","description":"Ranking type (default: `best_sellers`)"},"country":{"enum":["us","au","br","ca","cn","fr","de","in","it","mx","nl","sg","es","tr","ae","gb","jp","sa","pl","se","be","eg","za","ie"],"type":"string","default":"us","description":"Marketplace country code (default: `us`)"},"category":{"type":"string","maxLength":200,"description":"Category slug, e.g. `electronics` or `software` (see https://apidirect.io/docs/amazon-categories)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0gS978Z625XgeBmVw3OXF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves Amazon best-seller, new releases, movers & shakers, most wished for, or gift ideas rankings for a specified product category and marketplace country.","exampleAgentPrompt":"What are the top best-selling electronics on Amazon US right now? Pull the first page of best_sellers for the electronics category.","exampleUseCases":[{"title":"Competitor product trend research","prompt":"What are the top 50 best-selling products in the software category on Amazon US? I want to see what's ranking on page 1 of the best_sellers list."},{"title":"Holiday gift idea discovery","prompt":"Show me Amazon's gift ideas list for the toys category in the US — just the first page so I can see what's popular this season."},{"title":"Market momentum tracking","prompt":"Which products are currently movers and shakers in the home and kitchen category on Amazon UK? Give me page 1 so I can see what's trending fast."}],"resultDescription":"Returns a ranked list of Amazon products for the requested category and list type, including product names, ASINs, rank positions, and related metadata such as prices and ratings, covering up to 50 items per page (two pages available for top 100 coverage).","failureModes":["Invalid or unsupported category slug returns an error or empty results","Unsupported country code results in a validation error","Page number outside 1–2 range is rejected","Rate limiting or payment failure returns a 402 response","Stale data if Amazon rankings haven't been refreshed recently"],"whenToPreferThis":"Use this endpoint when you need structured Amazon ranking data for a specific product category and list type (best sellers, new releases, movers & shakers, most wished for, gift ideas) across multiple international Amazon marketplaces, without scraping Amazon directly. Prefer this over general web search when you need clean, paginated, machine-readable ranking lists.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:07:45.642Z","isFirstParty":false,"canonicalSlug":"api-direct-amazon-best-sellers-rankings-9f8bb14d"}