> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Amazon Scraper by ScrapeBadger — Overview

> Scrape Amazon products, offers, reviews, listings, and seller data across 20 marketplaces with structured JSON responses.

## Scraper API for Amazon

Search products, fetch full product detail, list offers and reviews, pull bestsellers, new releases, and deals, and retrieve seller storefronts from Amazon — the world's largest online marketplace. The API handles authentication, anti-bot bypass, and marketplace routing automatically.

## Key Features

<CardGroup cols={3}>
  <Card title="20 Marketplaces" icon="earth-americas">
    Access all major Amazon marketplaces including US, UK, DE, FR, IT, ES, JP, CA, IN, AU, and more.
  </Card>

  <Card title="Anti-Bot Bypass" icon="shield-halved">
    Automatic AWS WAF bypass via Chrome TLS impersonation, fresh residential sessions, and origin warmup.
  </Card>

  <Card title="Rich Product Data" icon="box">
    Variants, badges, buybox, best-seller ranks, A+ content, specs, and frequently-bought-together.
  </Card>

  <Card title="Structured Data" icon="database">
    Clean JSON responses with normalized prices, ratings, reviews, offers, and seller feedback.
  </Card>

  <Card title="Country Proxies" icon="globe">
    Requests are routed through residential proxies matching the target marketplace for accurate pricing.
  </Card>

  <Card title="SDK Support" icon="code">
    First-class support via the ScrapeBadger Node.js and Python SDKs.
  </Card>
</CardGroup>

## Supported Marketplaces

Amazon operates across 20 country domains. Use the `domain` query parameter to target a specific one.

| Market | Domain | Market | Domain |
| - | - | - | - |
| :us: `com` | amazon.com | :gb: `co.uk` | amazon.co.uk |
| :de: `de` | amazon.de | :fr: `fr` | amazon.fr |
| :it: `it` | amazon.it | :es: `es` | amazon.es |
| :netherlands: `nl` | amazon.nl | :sweden: `se` | amazon.se |
| :poland: `pl` | amazon.pl | :canada: `ca` | amazon.ca |
| :mexico: `com.mx` | amazon.com.mx | :brazil: `com.br` | amazon.com.br |
| :japan: `co.jp` | amazon.co.jp | :india: `in` | amazon.in |
| :australia: `com.au` | amazon.com.au | :singapore: `sg` | amazon.sg |
| :united\_arab\_emirates: `ae` | amazon.ae | :saudi\_arabia: `sa` | amazon.sa |
| :tr: `com.tr` | amazon.com.tr | :egypt: `eg` | amazon.eg |

<Tip>
  If no `domain` is specified, it defaults to `com`. Use the [`/v1/amazon/markets`](/api-reference/endpoint/amazon/list-markets) endpoint to get the full list (with currency and locale) programmatically.
</Tip>

## Quick Start

<CodeGroup>
  ```javascript Node.js theme={null}
  import ScrapeBadger from "scrapebadger";

  const client = new ScrapeBadger({ apiKey: "YOUR_API_KEY" });

  const results = await client.amazon.search({
    query: "wireless earbuds",
    domain: "com",
    page: 1,
  });

  console.log(results.results);
  ```

  ```python Python theme={null}
  from scrapebadger import ScrapeBadger

  client = ScrapeBadger(api_key="YOUR_API_KEY")

  results = client.amazon.search(
      query="wireless earbuds",
      domain="com",
      page=1,
  )

  print(results.results)
  ```

  ```bash cURL theme={null}
  curl "https://scrapebadger.com/v1/amazon/search?query=wireless+earbuds&domain=com&page=1" \
    -H "x-api-key: YOUR_API_KEY"
  ```
</CodeGroup>

## Endpoints

| Endpoint | Method | Description |
| - | - | - |
| [`/v1/amazon/search`](/api-reference/endpoint/amazon/search-products) | GET | Search the Amazon catalog with filters and sorting |
| [`/v1/amazon/autocomplete`](/api-reference/endpoint/amazon/autocomplete) | GET | Keyword autocomplete suggestions |
| [`/v1/amazon/products/{asin}`](/api-reference/endpoint/amazon/get-product) | GET | Full product detail by ASIN |
| [`/v1/amazon/products/{asin}/offers`](/api-reference/endpoint/amazon/get-offers) | GET | All seller offers, including the Buy Box winner |
| [`/v1/amazon/products/{asin}/reviews`](/api-reference/endpoint/amazon/get-reviews) | GET | Customer reviews with filters |
| [`/v1/amazon/bestsellers`](/api-reference/endpoint/amazon/bestsellers) | GET | Top-selling products by category |
| [`/v1/amazon/new-releases`](/api-reference/endpoint/amazon/new-releases) | GET | Newly released products by category |
| [`/v1/amazon/deals`](/api-reference/endpoint/amazon/deals) | GET | Current deals and lightning deals |
| [`/v1/amazon/category`](/api-reference/endpoint/amazon/browse-category) | GET | List products within a browse-node category |
| [`/v1/amazon/sellers/{seller_id}`](/api-reference/endpoint/amazon/get-seller) | GET | Seller profile and feedback summary |
| [`/v1/amazon/sellers/{seller_id}/products`](/api-reference/endpoint/amazon/seller-products) | GET | Seller storefront listings |
| [`/v1/amazon/sellers/{seller_id}/feedback`](/api-reference/endpoint/amazon/seller-feedback) | GET | Buyer feedback entries for a seller |
| [`/v1/amazon/markets`](/api-reference/endpoint/amazon/list-markets) | GET | List all supported marketplaces |
| [`/v1/amazon/categories`](/api-reference/endpoint/amazon/list-categories) | GET | List department/category aliases |

## Credit Costs

| Endpoint | Cost |
| - | - |
| Search products | 5 credits |
| Get product detail | 10 credits |
| Get offers | 8 credits |
| Get reviews | 10 credits |
| Bestsellers | 5 credits |
| New releases | 5 credits |
| Deals | 5 credits |
| Browse category | 5 credits |
| Get seller | 3 credits |
| Seller products | 5 credits |
| Seller feedback | 3 credits |
| Autocomplete | 1 credit |
| List markets | 0 credits |
| List categories | 0 credits |
| Failed requests | 0 credits |

## Authentication

All requests require your API key in the `X-API-Key` header:

```bash theme={null}
curl "https://scrapebadger.com/v1/amazon/search?query=laptop" \
  -H "X-API-Key: YOUR_API_KEY"
```

## Anti-Bot Handling

Amazon protects its catalog with AWS WAF, IP-reputation scoring, and TLS/HTTP-2 fingerprinting. ScrapeBadger clears these automatically using Chrome TLS impersonation on fresh **residential** sessions matched to the target marketplace, plus an origin-warmup step that seeds a clean WAF-passing session before guarded endpoints (offers, autocomplete) are fetched. You never need to manage proxies, sessions, or CAPTCHAs.

<Note>
  For accurate pricing and availability, requests are routed through residential proxies in the marketplace's country. This is handled automatically based on the `domain` parameter.
</Note>

## Next Steps

<CardGroup cols={2}>
  <Card title="Search Products" icon="magnifying-glass" href="/api-reference/endpoint/amazon/search-products">
    Full API reference for searching the Amazon catalog
  </Card>

  <Card title="Get Product Detail" icon="box" href="/api-reference/endpoint/amazon/get-product">
    Retrieve full product detail for a specific ASIN
  </Card>
</CardGroup>

***

*ScrapeBadger is an independent tool and is not affiliated with, endorsed by, or sponsored by Amazon. "Amazon" is a trademark of Amazon.com, Inc., used here only to describe the platform this scraper is designed to work with.*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.