API documentation

Base URL & auth

https://api.webdataextractionservices.com

Send your key in the X-API-KEY header. Get one with 2,500 free credits at sign up.

curl "https://api.webdataextractionservices.com/v1/amazon/product?asin=B01MTB55WH" \
  -H "X-API-KEY: sk_live_..."

Credits

Call	Credits
Product / offers — cached hit	0.5
Product / offers — live scrape	1
Product search	1 per 25 results
Not found / empty / failed request	0 — never billed

UK costs the same as US. Cache vs live is chosen per request with mode and max_age_days (below).

GET /v1/amazon/product

A single ASIN — title, price, BSR, rating, buy-box seller, seller count, image.

Param	Notes
asin	required, 10 chars
country	us (default) or uk
mode	auto (default) · cache · live
max_age_days	cache freshness window (default 30). In auto, a cache hit newer than this is served; otherwise we scrape live.

{
  "source": "cache", "credits_charged": 0.5, "credits_remaining": 2499.5,
  "asin": "B01MTB55WH", "marketplace": "amazon-us",
  "title": "Anker Soundcore 2 …", "brand": "Anker", "price": 30.14, "currency": "USD",
  "bsr": 46, "rating": 4.5, "reviews_count": 152566,
  "buybox_seller": "ankerdirect", "buybox_seller_id": "A294P4X9EWVXLJ",
  "seller_count": 1, "fba": true, "image": "https://…", "as_of": "2026-06-27 18:36:38"
}

Live collection is US-only for now; UK is cache-served. Walmart is available via /v1/products/search.

GET /v1/amazon/offers

The multi-seller offer list for an ASIN — every seller with price, condition, FBA flag, and who holds the buy box.

Params: asin, country, mode, max_age_days (same as product).

{
  "source": "cache", "credits_charged": 0.5, "asin": "B01MTB55WH",
  "marketplace": "amazon-us", "offer_count": 3,
  "offers": [
    {"seller_name": "ankerdirect", "seller_id": "…", "price": 32.38, "fba": true, "is_buybox": true},
    {"seller_name": "amazon.com",  "seller_id": "…", "price": 29.99, "fba": true, "is_buybox": false}
  ]
}

GET /v1/products/search

Search our warehouse of ~4.3M tracked products (not a live SERP scrape).

Param	Notes
q	keyword (title/description). An anchor.
brand	exact brand. An anchor.
seller, category	refinements — combine with q or brand
price_min/max, rating_min/max, reviews_min, bsr_min/max, fba, seller_count_min/max	filters
sort	bsr(default) · rating · reviews · price · sales_estimate · seller_count
max_per_category, page, limit	paging (limit ≤ 500)
marketplace	amazon-us(default) · amazon-uk · walmart

Provide at least q or brand. Coverage is deep on tracked brands, not the full Amazon catalog.

Rate limits, errors & honesty

• Per-key rate limit ~10 req/s (burst 20) → 429 with Retry-After. Credits are the volume limit.
• 401 missing/invalid key · 402 out of credits · 404 not found (unbilled) · 422 bad params.
• Every record carries an as_of timestamp — data is observed, not real-time. Sales figures are estimates.