amazon-scraper-api-sdk

Official Node.js / TypeScript SDK for Amazon Scraper API. Pay only for successful (2xx) responses — non-2xx never cost you anything. Pricing starts at $0.90 per 1,000 requests on pay-as-you-go, drops to a flat $0.50 per 1,000 requests on Custom plans. 1,000 free requests on signup, no card. Drop into any Node.js project to fetch structured Amazon product data, run keyword searches, or queue async batches with webhook callbacks.

Benchmark (live production, 2026-04)

Measured on our own infrastructure against a 30-query mixed international set:

| Metric | Value | |---|---| | Median latency (product, US) | ~2.6 s | | P95 latency | ~6 s | | P99 latency | ~10.5 s | | Price / 1,000 Amazon products | $0.50 flat | | Concurrent threads (entry paid plan) | 50 | | Marketplaces supported | 20+ | | Billing unit | per successful (2xx) response |

Install

npm install amazon-scraper-api-sdk

Requires Node >= 18. ESM + CJS supported, TypeScript types included.

Quick start - single product

import { AmazonScraperAPI } from 'amazon-scraper-api-sdk';

const asa = new AmazonScraperAPI(process.env.ASA_API_KEY!);

const product = await asa.product({ query: 'B09HN3Q81F', domain: 'com' });

console.log(product.title);
// "Apple AirPods Pro (2nd Generation)..."
console.log(product.price);
// { current: 199.00, currency: 'USD', was: 249.00 }
console.log(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"],
  "specifications": { "Brand": "Apple", "Model Name": "AirPods Pro 2" },
  "_meta": { "tier": "direct", "duration_ms": 2634, "marketplace": "amazon.com" }
}

Keyword search

const results = await asa.search({
  query: 'wireless headphones',
  domain: 'co.uk',
  sort_by: 'avg_customer_review',
  pages: 1,
});

for (const r of results.results) {
  console.log(r.position, r.asin, r.title, r.price?.current);
}

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

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

console.log('batch id:', batch.id);
// SAVE THIS. The webhook signing secret is returned only once:
console.log('webhook secret:', batch.webhook_signature_secret);

// Alternatively poll:
const status = await asa.getBatch(batch.id);
console.log(`${status.processed_count}/${status.total_count} processed`);

Verifying webhook signatures

Every webhook POST carries X-ASA-Signature: sha256=<hmac-hex> over the raw body (same pattern as Stripe / GitHub):

import { verifyWebhookSignature } from 'amazon-scraper-api-sdk';

// Express / Fastify / Hono. Read the RAW body, not the parsed JSON.
app.post('/webhooks/asa', async (req, res) => {
  const signature = req.header('X-ASA-Signature');
  const rawBody = req.rawBody;
  const valid = await verifyWebhookSignature(signature, rawBody, process.env.WEBHOOK_SECRET!);
  if (!valid) return res.status(401).send('invalid signature');
  const { id, status, results } = req.body;
  // process results safely
});

What the API solves for you

Building a production-grade Amazon scraper in-house is a 2-4 week engineering sprint plus permanent 10-20% maintenance overhead. This SDK wraps Amazon Scraper API, which has already solved:

| Pain point | What we handle | |---|---| | Amazon CAPTCHAs / robot pages | Auto-detected, retried through a heavier proxy tier (datacenter, residential, premium). You never see them. | | Brittle CSS selectors | Extractor library updates as Amazon changes layouts. Your code doesn't care. | | 20+ marketplaces | amazon.de, .co.uk, .co.jp, .com.br, and more. Marketplace-specific parsing (language, currency, layout) handled. Pass domain: 'de', done. | | Country-matched residential IPs | For non-US targets we auto-route through IPs in that country (amazon.de uses German residential). Override with country: 'DE'. | | Rotating proxies + anti-fingerprinting | TLS fingerprints, headers, cookie handling. You never configure a proxy. | | Rate-limit retries with exponential backoff | Transparent. Your client only sees final results. | | Structured JSON output | Title, price, rating, reviews, variants, seller, images, categories. All parsed, typed. No BeautifulSoup selectors. | | Batch/async jobs | Submit 1,000 ASINs, get a webhook when done. |

Time saved: a greenfield Node.js Amazon scraper built to this feature set takes roughly 80 engineer-hours. This SDK is 10 minutes.

Error handling

Every non-2xx response follows a stable shape so you can switch on error.code:

try {
  await asa.product({ query: 'INVALID_ASIN', domain: 'com' });
} catch (err) {
  if (err.code === 'INSUFFICIENT_CREDITS') {
    // top up
  } else if (err.code === 'RATE_LIMITED') {
    await sleep(err.retryAfterMs);
  } else {
    throw err;
  }
}

| HTTP | code | When you see it | Recommended client action | |---|---|---|---| | 400 | INVALID_PARAMS | Missing query, unsupported domain, invalid sort_by | Fix request, don't retry | | 401 | INVALID_API_KEY | Missing, malformed, or revoked key | Verify ASA_API_KEY env; rotate if leaked | | 402 | INSUFFICIENT_CREDITS | Credit balance empty | Top up; balance refreshed on renewal | | 429 | RATE_LIMITED | Over request-rate budget (120 req/60s authed) | Honor Retry-After header, then retry | | 429 | CONCURRENCY_LIMIT | Over plan's parallel-thread cap | Drop parallelism or upgrade plan. X-Concurrency-Limit + X-Concurrency-Remaining headers guide backoff | | 502 | target_unreachable | Amazon down / all proxy tiers blocked | Retry after 30s. We already retried through 3 tiers before returning | | 502 | amazon-robot-or-human | Amazon CAPTCHA gate not resolvable | Retry; often transient. You're not charged | | 502 | extraction_failed | Amazon returned a page we can't parse | Report with X-Request-Id; no charge | | 503 | SERVICE_OVERLOADED | Global circuit breaker tripped | Honor Retry-After: 60. Rare; alerts us automatically | | 500 | INTERNAL_ERROR | Our bug | Report with X-Request-Id |

Flat-credit promise: all non-2xx responses are free. A basic request costs 5 credits (billing unit; end-customer price is $0.90 per 1,000 basic requests PAYG). Future JS-rendered calls will cost 15 credits. X-Request-Id header is returned on every response — paste it in any support ticket and we'll trace the request in under a minute.

API reference (typed)

class AmazonScraperAPI {
  constructor(apiKey: string, opts?: { baseUrl?: string; timeoutMs?: number; fetchImpl?: typeof fetch });

  product(params: {
    query: string;                            // ASIN or Amazon URL
    domain?: 'com' | 'co.uk' | 'de' | string; // 20 marketplaces
    language?: string;                        // 'en_US', 'de_DE', etc.
    add_html?: boolean;                       // include raw HTML in response
    country?: string;                         // residential IP country (ISO-2)
  }): Promise<AmazonProduct>;

  search(params: {
    query: string;
    domain?: AmazonDomain;
    sort_by?: 'best_match' | 'price_asc' | 'price_desc' | 'avg_customer_review' | 'newest';
    start_page?: number;
    pages?: number;
  }): Promise<AmazonSearchResult>;

  createBatch(params: {
    endpoint: 'amazon.product' | 'amazon.search';
    items: Array<Record<string, unknown>>;
    webhook_url?: string;
  }): Promise<BatchCreateResponse>;

  getBatch(id: string): Promise<BatchStatusResponse>;
}

Get an API key

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

Links

• Website: https://www.amazonscraperapi.com/
• Docs: https://amazonscraperapi.com/docs
• Status: https://amazonscraperapi.com/status
• Pricing: https://amazonscraperapi.com/pricing
• Support: [email protected] (quote the X-Request-Id header for fastest debugging)
• Python SDK: amazonscraperapi-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