amazonscraperapi-sdk 0.1.1

Official Python client for Amazon Scraper API (https://amazonscraperapi.com)

amazonscraperapi-sdk

Official Python SDK for Amazon Scraper API — flat-priced ($0.50 per 1,000 successful requests), no credits system, pay only for 2xx responses.

Benchmark (live production, 2026-04)

Metric	Ours	ScrapingBee $49 tier	ScraperAPI $49 tier
Median latency (product, US)	~2.6 s	~3.3 s	n/a
P95 latency	~6 s	~22 s	n/a
Price / 1,000 Amazon products	$0.50	$1.63	$12.25
Concurrent threads (entry paid)	50	10	20

Same 30-query mixed international set; we tied ScrapingBee on success rate and were 3–4× faster at P95.

---

Install

pip install amazonscraperapi-sdk

Requires Python ≥ 3.9. Built on httpx.

Quick start — single product

from amazonscraperapi import AmazonScraperAPI

asa = AmazonScraperAPI(api_key="asa_live_...")

product = asa.product(query="B09HN3Q81F", domain="com")

print(product["title"])
# → "Apple AirPods Pro (2nd Generation)..."
print(product["price"]["current"])
# → 199.00
print(product["rating"]["average"], product["rating"]["count"])
# → 4.7 58214

Example output (trimmed)

{
    "asin": "B09HN3Q81F",
    "title": "Apple AirPods Pro (2nd Generation)...",
    "brand": "Apple",
    "price": {"current": 199.00, "currency": "USD", "was": 249.00, "savings_pct": 20},
    "rating": {"average": 4.7, "count": 58214, "distribution": {"5": 0.81, "4": 0.12}},
    "availability": "In Stock",
    "buybox": {"seller": "Amazon.com", "ships_from": "Amazon.com", "prime": True},
    "images": ["https://m.media-amazon.com/images/I/...jpg"],
    "bullets": ["Active Noise Cancellation...", "Adaptive Audio..."],
    "variants": [{"asin": "B0BDHB9Y8H", "name": "USB-C", "price": 249.00}],
    "categories": ["Electronics", "Headphones", "Earbud Headphones"],
    "_meta": {"tier": "direct", "duration_ms": 2634, "marketplace": "amazon.com"},
}

Keyword search

results = asa.search(
    query="wireless headphones",
    domain="co.uk",
    sort_by="avg_customer_review",
    pages=1,
)

for r in results["results"]:
    print(r["position"], r["asin"], r["title"], r["price"].get("current"))

Async batch (up to 1,000 ASINs with webhook callback)

batch = asa.create_batch(
    endpoint="amazon.product",
    items=[
        {"query": "B09HN3Q81F", "domain": "com"},
        {"query": "B000ALVUM6", "domain": "de", "language": "de_DE"},
        # ... up to 1,000
    ],
    webhook_url="https://your.server/webhooks/asa",
)

print("batch id:", batch["id"])
# SAVE THIS — webhook signing secret is returned only once:
print("webhook secret:", batch["webhook_signature_secret"])

# Alternative: poll
status = asa.get_batch(batch["id"])
print(f"{status['processed_count']}/{status['total_count']}")

Verifying webhook signatures

from amazonscraperapi import verify_webhook_signature
from fastapi import FastAPI, Request, HTTPException
import json, os

app = FastAPI()

@app.post("/webhooks/asa")
async def asa_webhook(request: Request):
    raw = await request.body()
    signature = request.headers.get("X-ASA-Signature")
    if not verify_webhook_signature(signature, raw, secret=os.environ["WEBHOOK_SECRET"]):
        raise HTTPException(401, "invalid signature")
    payload = json.loads(raw)
    # process payload["results"]

What the API solves for you

A production Amazon scraper is a 2–4 week engineering project plus permanent maintenance. This SDK wraps a managed service that has already solved:

Pain point	What we handle	What breaks in OSS alternatives
Amazon CAPTCHAs / robot pages	Auto-detected, retried through a heavier proxy tier (DC → residential → premium)	Most top OSS scrapers have no anti-bot layer; issues like scrapehero-code#12 "Page blocked by Amazon" are common
Brittle CSS selectors	Extractors update weekly as Amazon changes layouts	Popular repos like tducret/amazon-scraper-python (881⭐, last release 2021) and drawrowfly/amazon-product-api (743⭐, dormant since Jan 2021) have open "API not returning titles/thumbnails" tickets — Amazon's DOM churns monthly
20+ marketplaces	amazon.de, .co.uk, .co.jp, .com.br, ... each with marketplace-specific parsing quirks	Most OSS scrapers target amazon.com only. scrapehero-code issue #2 is literally "Does not Work with Amazon.de" — still open
Country-matched residential IPs	amazon.de auto-routes through German IPs; override with country="DE"	OSS repos either ignore proxies or require you to BYO + figure out residential-vs-DC trade-offs yourself
Rotating proxies + anti-fingerprinting	TLS fingerprints, headers, cookies handled	Even drawrowfly (richest OSS) does UA randomization only — no TLS fingerprinting
Rate-limit retries	Transparent exponential backoff	BYO
Structured JSON output	Title, price, rating, reviews, variants, seller, images — parsed, typed	Half the popular repos return just title/price/rating; everything else is your BeautifulSoup parser to maintain
Batch/async jobs	1,000 ASINs submitted, webhook-delivered on completion	Only 2 of the top 10 OSS scrapers support any form of concurrency

Time saved: a greenfield Python Amazon scraper built to this spec takes ~80 engineer-hours (including anti-bot handling and marketplace variants). This SDK is 10 minutes.

Error handling

All failures follow a stable shape so you can match on code:

from amazonscraperapi import AmazonScraperAPI, AsaError
import time

asa = AmazonScraperAPI(api_key="asa_live_...")

try:
    product = asa.product(query="INVALID_ASIN", domain="com")
except AsaError as e:
    if e.code == "INSUFFICIENT_CREDITS":
        pass  # top up
    elif e.code == "RATE_LIMITED":
        time.sleep(e.retry_after)
    elif e.code in ("target_unreachable", "amazon-robot-or-human"):
        # non-2xx — you were not charged. safe to retry.
        pass
    else:
        raise

HTTP	code	When you see it	Recommended action
400	INVALID_PARAMS	Missing query, unsupported domain, bad sort_by	Fix request; don't retry
401	INVALID_API_KEY	Missing, malformed, revoked	Verify ASA_API_KEY; rotate if leaked
402	INSUFFICIENT_CREDITS	Balance empty	Top up; renews each billing cycle
429	RATE_LIMITED	Over 120 req/60s per user	Honor Retry-After; retry
429	CONCURRENCY_LIMIT	Over plan's parallel cap	Reduce parallelism or upgrade. Headers X-Concurrency-* guide backoff
502	target_unreachable	Amazon down / all proxy tiers blocked	Retry after 30s — already retried through 3 tiers on our side
502	amazon-robot-or-human	Amazon challenge not resolvable	Retry. Often transient. Not charged
502	extraction_failed	Layout we can't parse (Amazon changed)	Report with X-Request-Id. Not charged. Fixed by us fast
503	SERVICE_OVERLOADED	Global circuit breaker	Honor Retry-After: 60. Rare
500	INTERNAL_ERROR	Our bug	Report with X-Request-Id

Flat-credit promise: non-2xx responses are free. Every response has X-Request-Id for traceability — quote it in any support ticket.

Get an API key

app.amazonscraperapi.com — 1,000 free requests on signup, no credit card required.

Links

• Docs: https://amazonscraperapi.com/docs
• Status: https://amazonscraperapi.com/status
• Pricing: https://amazonscraperapi.com/pricing
• Support: [e-mail]
• Node SDK: amazon-scraper-api-sdk · Go SDK: github.com/ChocoData-com/amazon-scraper-api-sdk-go · CLI: amazon-scraper-api-cli · MCP server: amazon-scraper-api-mcp

License

MIT