# Scrapier — Amazon API > Search results, product pages, best sellers, daily deals, reviews, sellers and influencer shops from Amazon, as structured JSON. Base URL: https://api.scrapier.io/api/v2 · Auth: header `X-API-Key: ` · Synchronous: HTTP 200 returns {"success": true, "data": {...}} · Paginate by sending data.next_cursor back as `cursor` until it is null · Paths keep the trailing slash. Live parameter source (no auth): https://api.scrapier.io/api/v2/endpoints · Docs: https://docs.scrapier.io/api-reference/amazon.md ## GET /amazon-asin-lookup/ Amazon ASIN Lookup: Structured Amazon data: send `asins`. Single lookup, 2 credits per successful call. Cost: 2 credits per successful call · Pagination: single lookup · Results: data.product Parameters: - asins (required, string, example B07GBZ4Q68): One 10-character ASIN or Amazon product URL. Returns one product; next_cursor is always null. - domain (optional, string, default amazon.com): Allowed marketplace override. Product URLs otherwise select their own marketplace. - language (optional, string, default en): Storefront language code, e.g. en, en_US, de. - zip_code (optional, string): Optional delivery postal code; adds up to three setup requests per attempt. - cursor (optional, string): 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. - raw_data (optional, boolean, default 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. Example: curl "https://api.scrapier.io/api/v2/amazon-asin-lookup/?asins=B07GBZ4Q68" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/amazon/amazon-asin-lookup.md ## GET /amazon-bestsellers/ Amazon Best Sellers: Get ranked products from an Amazon Best Sellers category URL, with price, rating, review count and list position. Cost: 1 credit per successful call · Pagination: cursor · Results: data.products Parameters: - url (required, string, example https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics/): Amazon Best Sellers category URL (contains best-sellers / zgbs). Required on first call. - cursor (optional, string): 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. - language (optional, string): Optional Accept-Language primary tag (e.g. en-US, de-DE) - depth_of_crawl (optional, integer, default 1): 1 = main category only; 2+ = also scrape subcategories (max 5) - raw_data (optional, boolean, default 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. Notes: - `url` must be a Best Sellers category URL, not a search or product URL. - `depth_of_crawl` is 1 for the main category only; 2 or more also scrapes subcategories (max 5). - `language` takes an Accept-Language tag such as en-US or de-DE. Example: curl "https://api.scrapier.io/api/v2/amazon-bestsellers/?url=https%3A%2F%2Fwww.amazon.com%2FBest-Sellers-Electronics%2Fzgbs%2Felectronics%2F" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/amazon/amazon-bestsellers.md ## GET /amazon-keyword-suggestion/ Amazon Keyword Suggestions: Get Amazon search-box autocomplete suggestions for a keyword in one call. Cost: 1 credit per successful call · Pagination: single lookup · Results: data.result Parameters: - queries (required, string, example iphone): Search keyword. Lookup endpoint -- next_cursor null. - max_items (optional, integer, default 50): Maximum number of items to return. The catalog has no description for this parameter yet; the default is usually right. - raw_data (optional, boolean, default 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. Notes: - `queries` takes one keyword per call. - `max_items` has no description in the catalog yet; its default is 50. Example: curl "https://api.scrapier.io/api/v2/amazon-keyword-suggestion/?queries=iphone" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/amazon/amazon-keyword-suggestion.md ## GET /amazon-product/ Amazon Products: Search Amazon by keyword or URL and get product listings, or send a product URL to get that single product. Cost: 1 credit per successful call · Pagination: cursor · Results: data.item_types Parameters: - query (optional, string, default keyboard): Search keyword. Builds the marketplace search URL (see location_name / se_domain) when url is omitted. Required first call unless url given. Aliases: queries, keyword, q. - url (optional, string): Amazon search/category URL or product /dp/ URL. Takes precedence over query. Product URLs return a single result with next_cursor=null; search URLs paginate. Aliases: urls. - cursor (optional, string): 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 (optional, string, one of: United States|Australia|Belgium|Brazil|Canada|France|Germany|India|Italy|Japan|Mexico|Netherlands|Poland|Saudi Arabia|Singapore|Spain|Sweden|United Arab Emirates|Turkiye|Egypt|United Kingdom, default United States): Marketplace + delivery location. Sets the Amazon domain, currency and delivery ZIP (prices/delivery dates as a shopper there sees them). Aliases: location, location_code (e.g. 2840), country (ISO2). - language_name (optional, string, one of: 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)): Storefront language, as a name ("English (United States)") or code (en_US). Default: the marketplace language. Aliases: language, language_code. - se_domain (optional, string): Amazon domain override (amazon.com, amazon.co.uk, amazon.de, …). Default: chosen from location_name. - zip_code (optional, string): Delivery postal code override (default: the marketplace capital, e.g. 10001 for the US). Aliases: postal_code, zip. - set_delivery_location (optional, boolean, default true): Pin the session delivery location to zip_code before scraping (2 extra requests per session). false = whatever location Amazon infers from the proxy IP (off-country IPs may get no prices). - price_min (optional, integer): Minimum product price (marketplace currency). - price_max (optional, integer): Maximum product price (marketplace currency). - sort_by (optional, string, one of: relevance|featured|price_low_to_high|price_high_to_low|avg_customer_review|newest_arrival|best_sellers): Result sorting. Default: Amazon's "Featured" order. - department (optional, string): Amazon department, e.g. "Electronics", "Books", "Home & Kitchen" (or a raw search alias like "electronics"). - search_param (optional, string): Extra Amazon search URL params, e.g. "&rh=p_72:1248882011". Ignored when price_min, price_max or sort_by is set. - tag (optional, string): Your own identifier (max 255 chars), echoed on every result. - depth (optional, integer, default 100, locked in cursor): Max products across all pages, organic + sponsored (max 700). Pagination stops once reached. Alias: max_items. - max_crawl_pages (optional, integer, default 7, locked in cursor): Max search-result pages to walk; next_cursor is null after this page. Alias: max_pages. - raw_data (optional, boolean, default 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. One of: query or url Notes: - Send one of `query` or `url` on the first call. If both are present, `url` wins. - A product URL returns a single result and no further pages; search and category URLs paginate. - `price` is an object with `value` and `currency` in this endpoint's sample. - `depth` caps the products collected across all pages (default 100, max 700) and `max_crawl_pages` caps the pages walked (default 7). Both are locked into the cursor. - `set_delivery_location` is on by default and costs 2 extra requests per session; turn it off to use whatever location Amazon infers from the proxy IP, which can return no prices. Example: curl "https://api.scrapier.io/api/v2/amazon-product/?query=keyboard" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/amazon/amazon-product.md ## GET /amazon-review/ Amazon Product Reviews: Get the reviews Amazon shows for a product from its ASIN or product URL, with rating, text, author and date. Cost: 2 credits per successful call · Pagination: single lookup · Results: data.reviews Parameters: - asins (required, string, example B0B2RM68G2): Bare ASIN or amazon.com product URL (/dp/, /gp/product/, slugged). Single lookup -- next_cursor always null. CAP: logged-out Amazon serves only the product page's "Top reviews" card (up to 8 US + up to ~5 international reviews); the full paginated list requires sign-in (stated in the `warning` field). Unknown ASIN / no reviews -> 404; Amazon wall on every attempt -> 502; bad input -> 400. - raw_data (optional, boolean, default 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. Notes: - Only the product page's Top reviews card is available logged out: up to 8 US reviews plus up to about 5 international ones. The full paginated list needs a sign-in and is not offered; the `warning` field states the cap. - An unknown ASIN or a product with no reviews returns 404; a bad input returns 400. - `asins` takes one ASIN or product URL per call. - `rating` is an object with `value` and `max`. Example: curl "https://api.scrapier.io/api/v2/amazon-review/?asins=B0B2RM68G2" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/amazon/amazon-review.md ## GET /amazon-search/ Amazon Search: Search Amazon by keyword and get product results with price, rating and position, with marketplace and sort order options. Cost: 1 credit per successful call · Pagination: cursor · Results: data.products Parameters: - query (required, string, example Playstation): Search keyword (required first call). - cursor (optional, string): 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_code (optional, string, one of: com|co.uk|de|in|ca|it|es|fr, default com, locked in cursor): Amazon marketplace: com, co.uk, de, in, ca, it, es, fr (fr is AWS-WAF gated and may return 502). - sort_by (optional, string, one of: relevanceblender|price-asc-rank|price-desc-rank|review-rank|date-desc-rank|exact-aware-popularity-rank, default relevanceblender, locked in cursor): Amazon sort key. - category (optional, string): Search category (optional) - browse_node (optional, integer): Browse node ID (optional) - node_hierarchy (optional, string): Node hierarchy (optional) - max_pages (optional, integer, default 1): First 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). - raw_data (optional, boolean, default 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. Notes: - `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. Example: curl "https://api.scrapier.io/api/v2/amazon-search/?query=Playstation" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/amazon/amazon-search.md ## GET /amazon-seller-scraper/ 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. Cost: 3 credits per successful call · Pagination: cursor · Results: data.products Parameters: - search_type (optional, string, one of: keyword|asin, default 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. - queries (required, string, example 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 (optional, string): 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 (optional, string, one of: United States|Australia|Belgium|Brazil|Canada|France|Germany|India|Italy|Japan|Mexico|Netherlands|Poland|Saudi Arabia|Singapore|Spain|Sweden|United Arab Emirates|Turkiye|Egypt|United Kingdom, default United States): search_type=asin: marketplace + delivery location (default United States). Aliases: location, location_code, country. - language_name (optional, string, one of: 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)): search_type=asin: storefront language, name or code (en_US). Aliases: language, language_code. - se_domain (optional, string): search_type=asin: Amazon domain override (amazon.co.uk, amazon.de, ...). - zip_code (optional, string): search_type=asin: delivery postal code override (default: marketplace capital). - tag (optional, string): Your own identifier (max 255 chars), echoed on every result. - max_offers (optional, integer, default 100): search_type=asin: max offers (sellers) per ASIN, including the buybox offer (default 100, max 500). - seller_details (optional, boolean, default true): search_type=asin: fetch each seller profile for business name / phone / address (one extra request per seller). - raw_data (optional, boolean, default 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. Notes: - In keyword mode a product URL or ASIN returns one lookup and no further pages; with `search_type` `asin` it pages through the offers. - `location_name`, `language_name`, `se_domain` and `zip_code` only apply when `search_type` is `asin`. - `seller_details` fetches each seller's profile with one extra request per seller (on by default). - `queries` takes one input per call. Example: curl "https://api.scrapier.io/api/v2/amazon-seller-scraper/?queries=laptop" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/amazon/amazon-seller-scraper.md ## GET /amazon-shop/ Amazon Influencer Shop: Get an Amazon influencer storefront from its shop URL or handle, with profile details, social links and curated lists. Cost: 1 credit per successful call · Pagination: cursor · Results: data.lists Parameters: - urls (required, string, example https://www.amazon.com/shop/pattyy.p, locked in cursor): Amazon influencer shop URL or bare handle. Required first call. - cursor (optional, string): 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. - raw_data (optional, boolean, default 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. Notes: - `urls` accepts one shop URL or handle per call. Example: curl "https://api.scrapier.io/api/v2/amazon-shop/?urls=https%3A%2F%2Fwww.amazon.com%2Fshop%2Fpattyy.p" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/amazon/amazon-shop.md ## GET /amazon-todays-deals/ Amazon Today's Deals: List Amazon's current deals with price, price before the discount, savings, rating and review count. Filters are optional. Cost: 1 credit per successful call · Pagination: cursor · Results: data.deals Parameters: - cursor (optional, string): 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. - department (optional, string): First call only (locked into the cursor). Optional department name (e.g. Electronics, Home & Kitchen, Books, Toys & Games) or Amazon browse-node id. Empty = all. - deal_type (optional, string, one of: all|best_deal|lightning_deal|coupon, default all): First call only. all | best_deal | lightning_deal | coupon - prime_exclusive (optional, boolean, default false): First call only. Only Prime-exclusive deals - min_discount (optional, integer): First call only. Minimum discount % (0-100) - max_discount (optional, integer): First call only. Maximum discount % (0-100) - min_price (optional, integer): First call only. Minimum price in USD - max_price (optional, integer): First call only. Maximum price in USD - raw_data (optional, boolean, default 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. No parameter is marked required; send at least one input (see descriptions). Notes: - No input is required; every filter is optional. - The filters (`department`, `deal_type`, `prime_exclusive`, `min_discount`, `max_discount`, `min_price`, `max_price`) are read on the first call only and locked into the cursor. Example: curl "https://api.scrapier.io/api/v2/amazon-todays-deals/" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/amazon/amazon-todays-deals.md