Amazon Sellers
Find who sells the products for a search term, search URL, product URL or ASIN, with seller business name, phone, address and offers.
Overview
Section titled “Overview”Send a search term, an Amazon search URL, a product URL or a bare ASIN in queries. By default (search_type keyword) you get products back, each with the seller’s name, business name, phone and address, plus product details such as price, brand and the offers on the listing.
Set search_type to asin to list every offer on one ASIN instead: seller, price, condition, ships-from, seller rating and delivery dates, with each seller’s business name, phone and address (seller_details). That mode pages through about 10 sellers per call and returns a product-info block on page 1; max_offers caps the sellers per ASIN (default 100, max 500).
A search term or search URL paginates with cursor. In keyword mode a product URL or ASIN is a single lookup with next_cursor set to null.
Use cases
Section titled “Use cases”- Build a list of third-party sellers in a product category.
- Identify the business behind a listing you compete with.
- Check which sellers hold offers on a product.
Request
Section titled “Request”curl -G "https://api.scrapier.io/api/v2/amazon-seller-scraper/" \ -H "X-API-Key: YOUR_API_KEY" \ --data-urlencode "queries=laptop" \ --max-time 210const params = new URLSearchParams({ queries: "laptop" });
const res = await fetch(`https://api.scrapier.io/api/v2/amazon-seller-scraper/?${params}`, { headers: { "X-API-Key": "YOUR_API_KEY" }, signal: AbortSignal.timeout(210_000),});const body = await res.json();if (!res.ok) throw new Error(body.error ?? body.detail ?? `HTTP ${res.status}`);
console.log(body.data.products);import requests
resp = requests.get( "https://api.scrapier.io/api/v2/amazon-seller-scraper/", headers={"X-API-Key": "YOUR_API_KEY"}, params={"queries": "laptop"}, timeout=210,)body = resp.json()if not resp.ok: raise RuntimeError(body.get("error") or body.get("detail"))
print(body["data"]["products"])curl -X POST "https://api.scrapier.io/api/v2/amazon-seller-scraper/" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"queries":"laptop"}' \ --max-time 210Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
X-API-Key header | string | yes | — | Your API key from the dashboard. |
search_type | string | no | keyword | keyword (default) = search term / search URL -> products with their buybox seller contact details. asin = DataForSEO-style Sellers lookup: queries are ASINs or product URLs; returns every offer (seller, price, condition, ships from, seller rating, delivery dates) with each seller profilebusiness name / phone / address, plus a product_info block. keywordasin |
queries | string | yes | e.g. laptop | Search term, Amazon search URL, product URL or bare ASIN. Required on the first call. A product URL / ASIN is a single lookup (next_cursor null) in keyword mode; with search_type=asin it pages through the ASIN offers, ~10 sellers per call (page 1 also returns product_info). |
cursor | string | no | — | Pagination cursor returned in the previous response's next_cursor. Pass it back unchanged to fetch the next page. When next_cursor is null, you have reached the last page. |
location_name | string | no | United States | search_type=asin: marketplace + delivery location (default United States). Aliases: location, location_code, country. United StatesAustraliaBelgiumBrazilCanadaFranceGermanyIndiaItalyJapanMexicoNetherlandsPolandSaudi ArabiaSingaporeSpainSwedenUnited Arab EmiratesTurkiyeEgyptUnited Kingdom |
language_name | string | no | — | search_type=asin: storefront language, name or code (en_US). Aliases: language, language_code. English (United States)Arabic (Saudi Arabia)Arabic (U.A.E.)Chinese (Simplified)Chinese (Traditional)Czech (Czech Republic)Dutch (Netherlands)English (Australia)English (Canada)English (India)English (U.A.E.)English (United Kingdom)French (Canada)French (France)German (Germany)Hebrew (Israel)Hindi (India)Italian (Italy)Japanese (Japan)Korean (Korea)Polish (Poland)Portuguese (Brazil)Spanish (Mexico)Spanish (Spain)Spanish (United States)Swedish (Sweden)Turkish (Turkey) |
se_domain | string | no | — | search_type=asin: Amazon domain override (amazon.co.uk, amazon.de, ...). |
zip_code | string | no | — | search_type=asin: delivery postal code override (default: marketplace capital). |
tag | string | no | — | Your own identifier (max 255 chars), echoed on every result. |
max_offers | integer | no | 100 | search_type=asin: max offers (sellers) per ASIN, including the buybox offer (default 100, max 500). |
seller_details | boolean | no | true | search_type=asin: fetch each seller profile for business name / phone / address (one extra request per seller). |
Advanced
| Name | Type | Default | Description |
|---|---|---|---|
use_proxy | boolean | true | Route the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise. |
raw_data | boolean | false | When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under raw_responses, in place of the formatted items. When false (default) you get the formatted output. Pagination (cursor / next_cursor) works the same in both modes. |
Response
Section titled “Response”{ "success": true, "data": { "queries": "wireless keyboard", "search_url": "https://www.amazon.com/s?k=wireless+keyboard", "page": 1, "page_size": 10, "total_pages": 20, "products": [ { "input_url": "B0BTQ3HXRS", "id": "420058c4-e29c-464e-981c-b5f6d17d6699", "url": "https://www.amazon.com/dp/B0BTQ3HXRS", "name": "Sweetwater Sound", "business_name": "Sweetwater Sound LLC", "phone": "800-410-6887", "address": "5501 US HIGHWAY 30 W, FORT WAYNE, IN, 46818-8998, US", "product": { "title": "Yamaha CK Series 88-Key Stage Keyboard with Built-In Speakers, Black (CK88)", "url": "https://www.amazon.com/dp/B0BTQ3HXRS", "asin": "B0BTQ3HXRS", "price": { "value": 1499.99, "currency": "$" }, "list_price": { "value": 1499.99, "currency": "$" }, "brand": "Yamaha", "stars": 4.5, "reviews_count": 73, "in_stock_text": "In Stock", "features": [ "Two split points increase flexibility to play three different sounds across the keyboard." ], "bestseller_ranks": [ { "rank": 10001, "category": "Musical Instruments" }, { "rank": 76, "category": "Portable & Arranger Keyboards" } ], "offers": [ { "seller": "Sweetwater Sound", "seller_url": "https://www.amazon.com/gp/help/seller/at-a-glance.html/ref=dp_merchant_link?ie=UTF8&seller=A2OH8CUXAUQ6XZ&asin=B0BTQ3HXRS&ref_=dp_merchant_link", "ships_from": null, "price": { "value": 1499.99, "currency": "$" }, "condition": "New", "is_buy_box_winner": true } ], "category_page_data": { "page_number": 1, "sale_summary": null, "is_sponsored": false, "bestseller_badge": null, "product_position": 1 }, "input": "https://www.amazon.com/dp/B0BTQ3HXRS" }, "scraped_at": "2026-09-14T04:25:11.116Z" } ], "next_cursor": "eyJxIjoid2lyZWxlc3Mga2V5Ym9hcmQiLCJwIjoxLCJzIjpbIkIwMDRONjI3S1MiLCJCMDc5SkxZNU01IiwiQjAxNEVVUU9HSyIsIkIwOVAzM1JXRkoiLCJCMEYzN0xZMUZOIiwiQjBEMTROMlFaRiIsIkIwSERDN0RXUkYiLCJCMENIOVRQSjNWIiwiQjA3RDM0TDU3RiIsIkIwRFhMMjM5VzEiXSwibiI6MTB9" }}Bad input. The exact message varies by endpoint.
{ "success": false, "error": "…"}Balance below the endpoint’s price.
{ "error": "Insufficient credits. Buy more to scrape more.", "balance": 1, "required": 2}Invalid or unknown API key.
{ "detail": "Authentication service unavailable or invalid API key."}Throttled — wait for Retry-After.
{ "detail": "Request was throttled. Expected available in N seconds."}Sample from the live catalog; arrays trimmed to 3 items. Results are in data.products.
Response fields
Section titled “Response fields”| Field | Type | Example | Description |
|---|---|---|---|
queries | string | wireless keyboard | — |
search_url | string | https://www.amazon.com/s?k=wireless+keyboard | — |
page | integer | 1 | — |
page_size | integer | 10 | — |
total_pages | integer | 20 | Total pages available for the search. |
products | array | [1 item] | The results. |
next_cursor | string | eyJxIjoid2lyZWxlc3Mga2V5Ym9hcmQiLCJwIjoxLCJzI… | Pass back as cursor for the next page. null on the last page. |
products[].input_url | string | B0BTQ3HXRS | — |
products[].id | string | 420058c4-e29c-464e-981c-b5f6d17d6699 | — |
products[].url | string | https://www.amazon.com/dp/B0BTQ3HXRS | — |
products[].name | string | Sweetwater Sound | — |
products[].business_name | string | Sweetwater Sound LLC | The seller's registered business name. |
products[].phone | string | 800-410-6887 | — |
products[].address | string | 5501 US HIGHWAY 30 W, FORT WAYNE, IN, 46818-8… | — |
products[].product | object | {…} | Product details, including offers and best-seller ranks. |
products[].scraped_at | string | 2026-09-14T04:25:11.116Z | — |
Pagination
Section titled “Pagination”Pass data.next_cursor back as cursor until it is null. Required inputs are ignored once a cursor is sent. Each page is one billed call. More in Pagination.
const url = "https://api.scrapier.io/api/v2/amazon-seller-scraper/";let params = { queries: "laptop" };const items = [];
for (let page = 0; page < 10; page++) { // each page is one billed call const res = await fetch(`${url}?${new URLSearchParams(params)}`, { headers: { "X-API-Key": "YOUR_API_KEY" }, signal: AbortSignal.timeout(210_000), }); const body = await res.json(); if (!res.ok) throw new Error(body.error ?? body.detail ?? `HTTP ${res.status}`); const data = body.data; items.push(...(data.products ?? [])); if (!data.next_cursor) break; // null = last page params = { cursor: data.next_cursor };}import requests
URL = "https://api.scrapier.io/api/v2/amazon-seller-scraper/"HEADERS = {"X-API-Key": "YOUR_API_KEY"}params = {"queries": "laptop"}items = []
for _ in range(10): # each page is one billed call resp = requests.get(URL, headers=HEADERS, params=params, timeout=210) resp.raise_for_status() data = resp.json()["data"] items.extend(data.get("products") or []) if not data.get("next_cursor"): # None = last page break params = {"cursor": data["next_cursor"]}Errors
Section titled “Errors”Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.
| Status | Meaning | Retry? | Charged? |
|---|---|---|---|
400 | Bad or missing input. | No — fix the params | No |
401 / 403 | Missing, invalid or revoked API key. | No — fix the key | No |
402 | Out of credits (body has balance). | No — top up | No |
404 | Unknown endpoint slug. | No — check the slug | No |
429 / 503 | Busy or throttled. | Yes — after Retry-After | No |
5xx | Target site or upstream failure, or timeout. | Yes — with backoff | No |
- In keyword mode a product URL or ASIN returns one lookup and no further pages; with
search_typeasinit pages through the offers. location_name,language_name,se_domainandzip_codeonly apply whensearch_typeisasin.seller_detailsfetches each seller’s profile with one extra request per seller (on by default).queriestakes one input per call.
Related
Section titled “Related”- Amazon Products — Search Amazon by keyword or URL and get product listings, or send a product URL to get that single product.
- Amazon Search — Search Amazon by keyword and get product results with price, rating and position, with marketplace and sort order options.
- Amazon Product Reviews — Get the reviews Amazon shows for a product from its ASIN or product URL, with rating, text, author and date.