# Amazon Scraper API

> Developer documentation for https://amazonscraperapi.com - a pay-for-successful-responses Amazon scraping API. Structured JSON for product, search, and async batch endpoints across 20+ Amazon marketplaces.

Every page linked below is also available as raw Markdown by replacing `.html` with `.md` in the URL, or by appending `.md` to the path (e.g. `/docs/getting-started.md`).

## Overview

- [Getting started](https://amazonscraperapi.com/docs/getting-started.md): Make your first scrape in under 2 minutes. Get an API key, fire one cURL request, parse the response.
- [Changelog](https://amazonscraperapi.com/docs/changelog.md): Every visible change to the API, the SDKs, and the dashboard. Newest first. Breaking changes are flagged; we give 14 days of notice.

## API endpoints

- [Product endpoint](https://amazonscraperapi.com/docs/endpoints/product.md): Extract full product data for a single Amazon ASIN - ~55 structured fields including price, variations, buybox, images, category ladder.
- [Search endpoint](https://amazonscraperapi.com/docs/endpoints/search.md): Run Amazon keyword searches and get ranked product listings with organic/sponsored positions, prices, ratings, and images.
- [Batch endpoint (async)](https://amazonscraperapi.com/docs/endpoints/batch.md): Submit up to 1,000 ASINs or search queries in one call. Receive results via webhook or poll.

## Guides

- [Authentication](https://amazonscraperapi.com/docs/guides/authentication.md): How to authenticate requests - pass your API key as a Bearer token. Keys have prefixes, can be rotated, and are tied to a workspace.
- [Error codes & retry semantics](https://amazonscraperapi.com/docs/guides/errors.md): Complete list of error codes the API returns, when to retry, and how to back off. Only 2xx responses are billed.
- [Rate limits & concurrency](https://amazonscraperapi.com/docs/guides/rate-limits.md): Per-plan ceilings on sustained RPS and concurrent in-flight requests. What 429 means, how to check your current utilisation, and how to ask for more.
- [SDK quick-starts](https://amazonscraperapi.com/docs/guides/sdks.md): Install and first-request snippets for the official Node, Python, Go, and CLI SDKs. All four wrap auth, retries, rate limits, and typed responses.
- [Country, marketplace, and content language](https://amazonscraperapi.com/docs/guides/country-and-language.md): How our API routes traffic to the right Amazon marketplace and which languages each marketplace actually serves.
- [Billing policy](https://amazonscraperapi.com/docs/guides/billing.md): Exactly which response types cost credits. Simple rule - only successful (2xx) responses are billed.