Skip to main content

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 API

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

20 Marketplaces

Access all major Amazon marketplaces including US, UK, DE, FR, IT, ES, JP, CA, IN, AU, and more.

Anti-Bot Bypass

Automatic AWS WAF bypass via Chrome TLS impersonation, fresh residential sessions, and origin warmup.

Rich Product Data

Variants, badges, buybox, best-seller ranks, A+ content, specs, and frequently-bought-together.

Structured Data

Clean JSON responses with normalized prices, ratings, reviews, offers, and seller feedback.

Country Proxies

Requests are routed through residential proxies matching the target marketplace for accurate pricing.

SDK Support

First-class support via the ScrapeBadger Node.js and Python SDKs.

​
Supported Marketplaces

Amazon operates across 20 country domains. Use the domain query parameter to target a specific one.
MarketDomainMarketDomain
:us: comamazon.com:gb: co.ukamazon.co.uk
:de: deamazon.de:fr: framazon.fr
:it: itamazon.it:es: esamazon.es
:netherlands: nlamazon.nl:sweden: seamazon.se
:poland: plamazon.pl:canada: caamazon.ca
:mexico: com.mxamazon.com.mx:brazil: com.bramazon.com.br
:japan: co.jpamazon.co.jp:india: inamazon.in
:australia: com.auamazon.com.au:singapore: sgamazon.sg
:united_arab_emirates: aeamazon.ae:saudi_arabia: saamazon.sa
:tr: com.tramazon.com.tr:egypt: egamazon.eg
If no domain is specified, it defaults to com. Use the /v1/amazon/markets endpoint to get the full list (with currency and locale) programmatically.

​
Quick Start

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);

​
Endpoints

EndpointMethodDescription
/v1/amazon/searchGETSearch the Amazon catalog with filters and sorting
/v1/amazon/autocompleteGETKeyword autocomplete suggestions
/v1/amazon/products/{asin}GETFull product detail by ASIN
/v1/amazon/products/{asin}/offersGETAll seller offers, including the Buy Box winner
/v1/amazon/products/{asin}/reviewsGETCustomer reviews with filters
/v1/amazon/bestsellersGETTop-selling products by category
/v1/amazon/new-releasesGETNewly released products by category
/v1/amazon/dealsGETCurrent deals and lightning deals
/v1/amazon/categoryGETList products within a browse-node category
/v1/amazon/sellers/{seller_id}GETSeller profile and feedback summary
/v1/amazon/sellers/{seller_id}/productsGETSeller storefront listings
/v1/amazon/sellers/{seller_id}/feedbackGETBuyer feedback entries for a seller
/v1/amazon/marketsGETList all supported marketplaces
/v1/amazon/categoriesGETList department/category aliases

​
Credit Costs

EndpointCost
Search products5 credits
Get product detail10 credits
Get offers8 credits
Get reviews10 credits
Bestsellers5 credits
New releases5 credits
Deals5 credits
Browse category5 credits
Get seller3 credits
Seller products5 credits
Seller feedback3 credits
Autocomplete1 credit
List markets0 credits
List categories0 credits
Failed requests0 credits

​
Authentication

All requests require your API key in the X-API-Key header: 
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.
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.

​
Next Steps

Search Products

Full API reference for searching the Amazon catalog

Get Product Detail

Retrieve full product detail for a specific ASIN