Amazon Best Sellers API. Best sellers, on request.
Top 100 products of any category, ranked. We handle the proxies, blocks and platform changes.
Amazon Best Sellers API at a glance
Returns Amazon's Best Sellers of a category, ranked from the top, from its department, browse node or Best Sellers link, on any Amazon marketplace. Each product has its rank, ASIN, title, image, current price, star rating and exact rating count, and a book's author. The same category's New Releases come back the same way.
GET /v1/amazon/top_products
- 1 credit per page, $0.75–$1.97 per 1,000 pages
- 23 typed fields null when unknown
- 50 top 100 products per page, Amazon's rank in the list (1 = top)
- 100 credits free when you sign up, no card, so you can build before you spend
Send one request. Get up to 50 top 100 products back.
Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free.
$ npm install socialtapconst params = new URLSearchParams({
category: "electronics",
});
const res = await fetch(`https://socialtap.dev/v1/amazon/top_products?${params}`, {
headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, page, meta } = body;
console.log(data, meta.credits_charged);import os
import requests
res = requests.get(
"https://socialtap.dev/v1/amazon/top_products",
params={"category": "electronics"},
headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, page, meta = body["data"], body["page"], body["meta"]
print(data, meta["credits_charged"])require "json"
require "net/http"
uri = URI("https://socialtap.dev/v1/amazon/top_products")
uri.query = URI.encode_www_form('category' => 'electronics')
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = ENV.fetch("SOCIALTAP_API_KEY")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
body = JSON.parse(res.body)
raise "#{body["error"]["code"]}: #{body["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
pp body["data"]
puts body["meta"]["credits_charged"]<?php
$query = http_build_query([
'category' => 'electronics',
]);
$ch = curl_init('https://socialtap.dev/v1/amazon/top_products?' . $query);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('SOCIALTAP_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) >= 400) {
throw new RuntimeException($body['error']['code'] . ': ' . $body['error']['message']);
}
print_r($body['data']);
echo $body['meta']['credits_charged'], PHP_EOL;package main
import (
"encoding/json"
"fmt"
"log"
"net/http"
"net/url"
"os"
)
func main() {
q := url.Values{}
q.Set("category", "electronics")
req, err := http.NewRequest("GET", "https://socialtap.dev/v1/amazon/top_products?"+q.Encode(), nil)
if err != nil {
log.Fatal(err)
}
req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
res, err := http.DefaultClient.Do(req)
if err != nil {
log.Fatal(err)
}
defer res.Body.Close()
var body struct {
Data json.RawMessage `json:"data"`
Page json.RawMessage `json:"page"`
Meta map[string]any `json:"meta"`
Error *struct {
Code string `json:"code"`
Message string `json:"message"`
} `json:"error"`
}
if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
log.Fatal(err)
}
if body.Error != nil {
log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
}
fmt.Println(string(body.Data), body.Meta["credits_charged"])
}curl 'https://socialtap.dev/v1/amazon/top_products?category=electronics' \
-H "x-api-key: $SOCIALTAP_API_KEY"{
"data": [
{
"approximate_fields": [
"platform_specific.amazon.rating"
],
"attributes": [],
"availability": null,
"category": null,
"category_id": null,
"condition": null,
"condition_label": null,
"country_code": "US",
"currency": "USD",
"description": null,
"id": "B08JHCVHTY",
"max_price": null,
"media": [],
"original_price": null,
"platform": "amazon",
"platform_specific": {
"amazon": {
"availability_label": null,
"best_sellers_ranks": [],
"brand": null,
"categories": [],
"contributors": [],
"deal": null,
"features": [],
"is_sponsored": null,
"metrics": {
"bought_past_month_count": null,
"offer_count": null,
"rating_count": 281899,
"rating_distribution": null
},
"parent_asin": null,
"rank": 1,
"rating": 4.4,
"ships_from": null,
"variants": []
}
},
"price": 11.99,
"seller": null,
"shipping": {
"fee": null,
"is_offered": null
},
"thumbnail_url": "https://images-na.ssl-images-amazon.com/images/I/31YHGbJsldL._AC_UL900_SR900,600_.png",
"title": "blink plus plan with monthly auto-renewal",
"type": "product",
"unknown_fields": [
"media",
"attributes",
"platform_specific.amazon.contributors"
],
"url": "https://www.amazon.com/dp/B08JHCVHTY"
},
{
"approximate_fields": [
"platform_specific.amazon.rating"
],
"attributes": [],
"availability": null,
"category": null,
"category_id": null,
"condition": null,
"condition_label": null,
"country_code": "US",
"currency": "USD",
"description": null,
"id": "B0DCH8VDXF",
"max_price": null,
"media": [],
"original_price": null,
"platform": "amazon",
"platform_specific": {
"amazon": {
"availability_label": null,
"best_sellers_ranks": [],
"brand": null,
"categories": [],
"contributors": [],
"deal": null,
"features": [],
"is_sponsored": null,
"metrics": {
"bought_past_month_count": null,
"offer_count": null,
"rating_count": 20075,
"rating_distribution": null
},
"parent_asin": null,
"rank": 2,
"rating": 4.5,
"ships_from": null,
"variants": []
}
},
"price": 19,
"seller": null,
"shipping": {
"fee": null,
"is_offered": null
},
"thumbnail_url": "https://images-na.ssl-images-amazon.com/images/I/513OSdW4elL._AC_UL900_SR900,600_.jpg",
"title": "Apple EarPods Headphones with USB-C Plug, Wired Ear Buds with Built-in Remote to Control Music, Phone Calls, and Volume",
"type": "product",
"unknown_fields": [
"media",
"attributes",
"platform_specific.amazon.contributors"
],
"url": "https://www.amazon.com/dp/B0DCH8VDXF"
},
{
"approximate_fields": [
"platform_specific.amazon.rating"
],
"attributes": [],
"availability": null,
"category": null,
"category_id": null,
"condition": null,
"condition_label": null,
"country_code": "US",
"currency": "USD",
"description": null,
"id": "B0GJTFXNRX",
"max_price": null,
"media": [],
"original_price": null,
"platform": "amazon",
"platform_specific": {
"amazon": {
"availability_label": null,
"best_sellers_ranks": [],
"brand": null,
"categories": [],
"contributors": [],
"deal": null,
"features": [],
"is_sponsored": null,
"metrics": {
"bought_past_month_count": null,
"offer_count": null,
"rating_count": 13061,
"rating_distribution": null
},
"parent_asin": null,
"rank": 3,
"rating": 4.6,
"ships_from": null,
"variants": []
}
},
"price": 23,
"seller": null,
"shipping": {
"fee": null,
"is_offered": null
},
"thumbnail_url": "https://images-na.ssl-images-amazon.com/images/I/61Qd9Z9caRL._AC_UL900_SR900,600_.jpg",
"title": "Apple AirTag (2nd Generation): Tracker for Keychain, Wallet, and More; Locator with Sound; Simple One-Tap Setup with iPhone or iPad; Key Finder with up to 1.5X Precision Finding Range",
"type": "product",
"unknown_fields": [
"media",
"attributes",
"platform_specific.amazon.contributors"
],
"url": "https://www.amazon.com/dp/B0GJTFXNRX"
}
],
"page": {
"has_more": true,
"next_cursor": "c1.EXAMPLE_CURSOR",
"next_cursor_expires_at": "2026-10-26T12:00:00Z",
"end_reason": null
},
"meta": {
"request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
"platform": "amazon",
"source": "page",
"is_cached": false,
"credits_charged": 1,
"latency_ms": 0,
"fetched_at": "2026-10-25T12:00:00Z",
"input": null,
"credits_remaining": 9999,
"client_request_id": null,
"warnings": []
}
}import { SocialTap } from "socialtap";
const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY
const res = await client.amazon.topProducts.list({ category: "electronics" });
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
public class Main {
public static void main(String[] args) throws Exception {
String query = "category=" + encode("electronics");
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://socialtap.dev/v1/amazon/top_products?" + query))
.header("x-api-key", System.getenv("SOCIALTAP_API_KEY"))
.GET()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
// An error is {"error": {"code", "message", ...}}; success is {data, meta}, meta.credits_charged its price.
if (response.statusCode() >= 400) throw new RuntimeException(response.body());
System.out.println(response.body());
}
static String encode(String value) {
return URLEncoder.encode(value, StandardCharsets.UTF_8);
}
}using System.Text.Json;
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("SOCIALTAP_API_KEY"));
var query = string.Join("&",
"category=" + Uri.EscapeDataString("electronics"));
var res = await http.GetAsync("https://socialtap.dev/v1/amazon/top_products?" + query);
using var body = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
if (!res.IsSuccessStatusCode)
{
var error = body.RootElement.GetProperty("error");
throw new Exception($"{error.GetProperty("code")}: {error.GetProperty("message")}");
}
Console.WriteLine(body.RootElement.GetProperty("data"));
Console.WriteLine(body.RootElement.GetProperty("meta").GetProperty("credits_charged"));// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use std::env;
fn main() -> Result<(), Box<dyn std::error::Error>> {
let res = reqwest::blocking::Client::new()
.get("https://socialtap.dev/v1/amazon/top_products")
.query(&[("category", "electronics")])
.header("x-api-key", env::var("SOCIALTAP_API_KEY")?)
.send()?;
let ok = res.status().is_success();
let body: serde_json::Value = res.json()?;
if !ok {
return Err(format!("{}: {}", body["error"]["code"], body["error"]["message"]).into());
}
println!("{} {}", body["data"], body["meta"]["credits_charged"]);
Ok(())
}200 OK · GET https://socialtap.dev/v1/amazon/top_productsLong arrays and strings are shortened here. Real responses are complete.Docs One schema on 3 platforms.
The response reference lists every field, its type and when it is null. See the full schema.
Null means unknown
A field Amazon doesn't show is null, never zero or an empty string, so a real zero always means zero.
No input needed
Every parameter is optional: the plain request returns the default list.
Write one parser
Amazon, TikTok Shop and Facebook Marketplace answer in these fields, so the code that reads one reads them all.
platformstring- Platform ID (tiktokshop, facebook, …).
idstring- Platform-native product or listing ID (string).
urlstring- Canonical product page URL.
typestring- product: a catalog product a shop sells in many units, often in variants (TikTok Shop, Instagram and YouTube shopping); listing: a single item a person or business lists for sale (Facebook Marketplace). New values may be added; treat unknown values as product.
titlestring- Product name or listing title, as the seller wrote it.
descriptionstring- Description as plain text (paragraphs separated by blank lines); null when it has none or the source does not show it (lists and search results).
categorystring- The platform's most specific category label (Bicycles, Vitamins & Supplements), as shown; not normalized across platforms.
category_idstring- The platform's ID of that category (what its category browsing and filters take).
Live data from 33 platforms.
What teams build with the Amazon Best Sellers API.
Track a category's best sellers every day
Spot new products climbing a category
Find product ideas from top sellers
Compare best sellers across marketplaces
Watch a product's Best Sellers Rank
Good to know before you build.
- Amazon ranks the top hundred of each list, fifty to a page, so a list ends after its second page with page.end_reason end.
- platform_specific.amazon.rank is the product's place in the list you asked for. Description, specifications, seller and variations aren't on a list: send the ASIN to the Amazon Product API for them.
- A product with no featured offer shows the lowest of its offers as price, and platform_specific.amazon.metrics.offer_count counts them.
- list also takes movers_and_shakers, most_wished_for and gift_ideas, but Amazon shows no products in those three lists today, in any category or marketplace we checked. Most Wished For and Gift Ideas of a category Amazon names come back as an empty page with page.end_reason end. Movers & Shakers, and those two lists of a browse node sent alone, return not_found, because Amazon's page names no category for them.
- A category Amazon doesn't know returns not_found.
- Prices and lists are the marketplace's own, in its currency, and each marketplace has its own departments and slugs.
1 credit per page. Failed requests are free.
Buy credits once and spend them on any endpoint, on any platform.
| Source | Price per successful page | Per 1,000 pages |
|---|---|---|
Public page page | 1 credit | $0.75–$1.97 |
- Cache hits are free.
- Credits from packs and top-ups never expire.
- A monthly plan's credits are spent first, and what is left of them ends at each renewal.
- Prices exclude tax: sales tax is added at checkout where it applies.
- Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID.
Questions about the Amazon Best Sellers API.
More in the API reference.
How do I find a category's slug or node?
Which marketplaces does it support?
How much does the Amazon Best Sellers API cost?
How do I get the next page?
See what's on the list right now.
Run it in the playground, or copy the request into your code.
- No credit card
- Failed requests are free
- Works on all 218 endpoints