Docs

Documentation

Everything you need to make your first scrape, ship a production integration, and understand how billing works. For a hands-on path, start with Getting started.

Getting started

Make your first scrape in under 2 minutes - get a key, run one cURL, parse the response.

Authentication

API key format, rotation, and hygiene. Unauthorized requests never cost credits.

Product endpoint

Single-ASIN product scraping - ~55 structured fields including price, variations, buybox.

Search endpoint

Ranked search results with organic vs sponsored positions, prices, ratings, images.

Batch endpoint (async)

Submit up to 1,000 ASINs or queries in one call. Webhook or polled results.

Error codes

Complete list of error codes with retry semantics. Only 2xx costs credits, always.

Rate limits & concurrency

Per-plan ceilings on RPS and concurrent in-flight requests. How to check utilisation and request more.

SDK quick-starts

Install + first-request snippets for the official Node, Python, Go, and CLI SDKs.

Country, marketplace & language

How we route to the right Amazon marketplace and which languages each TLD actually serves.

Billing policy

Which responses cost credits - simple rule: only successful (2xx) responses are billed.

Changelog

Every visible change to the API, SDKs, and dashboard. Breaking changes get 14 days of notice.

Looking for an SDK?

We publish official SDKs for Node (amazon-scraper-api-sdk), Python (amazonscraperapi-sdk), Go (github.com/ChocoData-com/amazon-scraper-api-sdk-go), and a cross-platform CLI (amazonscraperapi-cli). Each ships with typed responses and the same auth + retry behaviour. See the SDK quick-starts.

For coding agents & LLMs

The entire docs corpus is available in LLM-friendly formats:

· /docs/llms.txt - manifest of every page with URLs and descriptions (llms.txt spec).
· /docs/llms-full.txt - single-file concatenation of every page for one-shot ingestion.
· /docs/<slug>.md - append .md to any doc URL for the raw Markdown source. Example: /docs/endpoints/product.md.

Every page also carries "Copy as Markdown", "Open in ChatGPT", and "Open in Claude" buttons in the top-right so you can hand the page to an agent in one click.