Skip to content

Search Amazon by keyword and get product results with price, rating and position, with marketplace and sort order options.

GET · POST1 credit / successful callCursor-paginated
GEThttps://api.scrapier.io/api/v2/amazon-search/Open in Playground

Send a keyword in query and get a page of Amazon search results with ASIN, product description, URL (dp_url), price, retail price, star rating (product_rating), review count (count_review), prime and sponsored flags and search position.

Pick the marketplace with domain_code (com, co.uk, de, and so on) and the order with sort_by. Both are locked into the cursor, so later pages keep the same marketplace and sort.

  • Monitor where products rank for a keyword.
  • Collect prices across Amazon marketplaces for the same search.
  • Build a product list for further lookups with amazon-review or amazon-seller-scraper.
Terminal window
curl -G "https://api.scrapier.io/api/v2/amazon-search/" \
-H "X-API-Key: YOUR_API_KEY" \
--data-urlencode "query=Playstation" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyes—Your API key from the dashboard.
querystringyese.g. PlaystationSearch keyword (required first call).
cursorstringno—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.
domain_codestringnocomAmazon marketplace: com, co.uk, de, in, ca, it, es, fr (fr is AWS-WAF gated and may return 502).
comco.ukdeincaitesfr
locked in cursor
sort_bystringnorelevanceblenderAmazon sort key.
relevanceblenderprice-asc-rankprice-desc-rankreview-rankdate-desc-rankexact-aware-popularity-rank
locked in cursor
categorystringno—Search category (optional)
browse_nodeintegerno—Browse node ID (optional)
node_hierarchystringno—Node hierarchy (optional)
max_pagesintegerno1First call only: front-load this many Amazon result pages (capped at 10). Cursor calls return one page (plus a refill page when it comes back thin).
Advanced
NameTypeDefaultDescription
use_proxybooleantrueRoute the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise.
raw_databooleanfalseWhen 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.
{
"success": true,
"data": {
"query": "laptop",
"domain_code": "com",
"sort_by": "relevanceblender",
"page": 1,
"page_size": 16,
"pages_fetched": 1,
"products": [
{
"asin": "B0EXAMPLE10",
"product_description": "Lenovo ThinkPad X1 Carbon Gen 11 14\" Laptop",
"img_url": "https://m.media-amazon.com/images/I/example._AC_UY218_.jpg",
"price": 1599,
"retail_price": 1899,
"product_rating": "4.6 out of 5 stars",
"count_review": 1248,
"dp_url": "https://www.amazon.com/Lenovo-ThinkPad-Carbon/dp/B0EXAMPLE10/ref=sr_1_1",
"prime": true,
"sponsored": false,
"is_sponsored": false,
"sales_volume": "500+ bought in past month",
"delivery_message": "FREE delivery Tue, Oct 7",
"manufacturer": null,
"series": null,
"variations": [],
"product_details": [],
"secondary_offer": 0,
"status_code": 200,
"status_message": "FOUND",
"keyword": "laptop",
"domain_code": "com",
"page": 1,
"selected_category": "aps",
"browse_node": null,
"node_hierarchy": null,
"result_count": 100000,
"categories": [
"Traditional Laptop Computers"
],
"similar_keywords": [],
"current_page": 1,
"sort_strategy": "relevanceblender",
"search_result_position": 0,
"position": 1
}
],
"next_cursor": "zc1.eNqFU01P..."
}
}

Sample from the live catalog; arrays trimmed to 3 items. Results are in data.products.

FieldTypeExampleDescription
querystringlaptop—
domain_codestringcom—
sort_bystringrelevanceblender—
pageinteger1—
page_sizeinteger16—
pages_fetchedinteger1How many result pages this call fetched.
productsarray[1 item]The results.
next_cursorstringzc1.eNqFU01P...Pass back as cursor for the next page. null on the last page.
products[].asinstringB0EXAMPLE10—
products[].product_descriptionstringLenovo ThinkPad X1 Carbon Gen 11 14" Laptop—
products[].img_urlstringhttps://m.media-amazon.com/images/I/example._…—
products[].priceinteger1599—
products[].retail_priceinteger1899—
products[].product_ratingstring4.6 out of 5 starsAverage star rating, as text.
products[].count_reviewinteger1248Number of reviews.
products[].dp_urlstringhttps://www.amazon.com/Lenovo-ThinkPad-Carbon…Link to the product page.
products[].primebooleantrue—
products[].sponsoredbooleanfalse—
products[].is_sponsoredbooleanfalse—
products[].sales_volumestring500+ bought in past month—
products[].delivery_messagestringFREE delivery Tue, Oct 7—
products[].manufacturernullnull—
products[].seriesnullnull—
products[].variationsarray[]—
products[].product_detailsarray[]—
products[].secondary_offerinteger0—
products[].status_codeinteger200—
products[].status_messagestringFOUND—
products[].keywordstringlaptopThe search keyword that returned the product.
products[].domain_codestringcom—
products[].pageinteger1—
products[].selected_categorystringaps—
products[].browse_nodenullnull—
products[].node_hierarchynullnull—
products[].result_countinteger100000—
products[].categoriesarray[1 item]—
products[].similar_keywordsarray[]—
products[].current_pageinteger1The results page the product was found on.
products[].sort_strategystringrelevanceblender—
products[].search_result_positioninteger0Position of the product in the search results.
products[].positioninteger1—

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-search/";
let params = { query: "Playstation" };
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 };
}

Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.

StatusMeaningRetry?Charged?
400Bad or missing input.No — fix the paramsNo
401 / 403Missing, invalid or revoked API key.No — fix the keyNo
402Out of credits (body has balance).No — top upNo
404Unknown endpoint slug.No — check the slugNo
429 / 503Busy or throttled.Yes — after Retry-AfterNo
5xxTarget site or upstream failure, or timeout.Yes — with backoffNo
  • domain_code and sort_by are set on the first call and reused for every page.
  • max_pages applies to the first call only: it front-loads that many result pages (capped at 10). Cursor calls return one page, plus a refill page when it comes back thin.
  • domain_code fr is gated by Amazon’s AWS WAF and may return 502.
  • category, browse_node and node_hierarchy are optional filters.
  • Locked into the cursor: domain_code, sort_by. Set them on the first call; later pages reuse them.
  • Amazon Products — Search Amazon by keyword or URL and get product listings, or send a product URL to get that single product.
  • Amazon Best Sellers — Get ranked products from an Amazon Best Sellers category URL, with price, rating, review count and list position.
  • Amazon Keyword Suggestions — Get Amazon search-box autocomplete suggestions for a keyword in one call.