Amazon Best Sellers API

Amazon Best Sellers

Features

• Regional category URL collectionSubmit one or more public Best Sellers or category-list URLs across the supported Amazon marketplaces in a single asynchronous task.
• Normalized product identityReceive stable product records with available IDs, titles, descriptions, source URLs, platform and resource labels, and collection timestamps.
• Commerce and reputation contextKeep available seller details, price values, ratings, review counts, and sold counts in explicit fields rather than parsing page markup.
• Media-ready product recordsUse normalized media objects with each product for catalogs, review queues, enrichment pipelines, and downstream visual analysis.

Parameters

How to Use

Submit known public Best Sellers URLs, monitor the asynchronous task, and page through the normalized product records.

1. Prepare one or more public Amazon Best Sellers or category-list URLs on a supported marketplace host.
2. Send urls and an optional results_limit from 1 through 2,000 to /v1/amazon/best-sellers, then save the returned task_id.
3. Poll /v1/tasks/{task_id} until the task succeeds or returns a failure.
4. Read data.results.items and request next_cursor while has_more remains true.

curl -X POST "https://api.socq.ai/v1/amazon/best-sellers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.amazon.com/Best-Sellers-Books/zgbs/books"],"results_limit":3}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Best Use Cases

• Category assortment snapshots: Turn selected Best Sellers pages into a bounded product inventory with source links and collection times for a defined research dataset.
• Price and reputation comparison: Compare available prices, ratings, review counts, and sold counts across returned products without scraping inconsistent page markup downstream.
• Product discovery enrichment: Add titles, seller context, descriptions, media, and public product URLs to shortlists discovered from category pages.

Pro Tips

• Use references on supported regional Amazon hosts whose paths contain /zgbs/ or /gp/bestsellers/. Unrelated Amazon paths are rejected before task creation.
• Set results_limit for the entire task, not for each submitted URL, and size it for the combined batch you need.
• Follow next_cursor until has_more is false because task results are returned through a separate cursor-paginated results view.
• Treat IDs, descriptions, seller data, prices, ratings, counts, media, URLs, and publication times as nullable rather than replacing missing values with zero or an empty object.
• Store collected_at with each record and schedule separate runs when you need point-in-time comparisons; the endpoint does not create a continuous feed.

Related APIs