# Real-Time Amazon Data - Product, Reviews, Offers, Sellers & Deals Data from Amazon

> Fast, reliable, and extensive Amazon data API - get products & ASIN data, reviews, offers, best sellers & deals, seller data, influencers, and more from Amazon in real-time.

## Overview

Real-Time Amazon Data is a fast, reliable, and extensive API for retrieving product, review, offer, seller, and deals data from Amazon in real-time. It returns structured JSON via REST across products, sellers, best sellers, deals, and influencers.

Who is this API for: developers building price-tracking and repricing tools, product research and market intelligence, review monitoring, seller and competitor analysis, and affiliate apps.

What it returns: product search and details by ASIN or category, product reviews (including top reviews and review details), multi-seller offers, best sellers, deals and deal products, seller profiles, reviews and products, influencer data, ASIN/GTIN conversion, and category lists.

Need help integrating? Contact support@openwebninja.com.
For high volume / large scale plans, please contact support@openwebninja.com.

## Endpoints

### GET /search - Product Search
Search for products & offers on Amazon with pagination support and multiple filters and options such as sort option, price range, product condition filter, and more.
Parameters:
- **query** (string, required): Search query (supports both free-form text queries or a product asin).
- page (integer, default: `1`): Results page to return.
- country (string, default: `US`, allowed: US | AU | BR | CA | CN | FR | DE | IN | IT | MX | NL | SG | ES | TR | AE | GB | JP | SA | PL | SE | BE | EG | ZA | IE): Sets the Amazon domain, marketplace country, language and currency.
- delivery_country (string): Delivery destination country (ISO 3166-1 alpha-2 code, e.g. `NL`). When set, delivery dates, shipping costs, availability and offers reflect delivery to this country instead of the marketplace's domestic delivery. Defaults to the marketplace country. Only specific `country` / `delivery_country` combinations are supported. Currently supported: `country` = `DE`, `FR`, `IT` or `ES` with `delivery_country` = `NL`. Other combinations return a 400 error. If you need another combination, contact us at support@openwebninja.com and we will look into adding it.
- sort_by (string, default: `RELEVANCE`, allowed: RELEVANCE | LOWEST_PRICE | HIGHEST_PRICE | REVIEWS | NEWEST | BEST_SELLERS): Return the results in a specific sort order.
- category_id (string, default: `aps (All Departments)`): Find products in a specific category / department (e.g. computers-intl-ship). Use the Product Category List endpoint to get a list of valid categories and their ids for the country specified in the request. For numeric Amazon category IDs, use the category parameter instead.
- category (string): Filter by specific numeric Amazon category. The category ID can be obtained from the Amazon category results URL, for example: https://amazon.com/s?node=2858778013 - the Amazon Category ID is `2858778013`. Multiple category values can be separated by comma (e.g. categoryId1,categoryId2).
- min_price (integer): Only return product offers with price greater than a certain value. Specified in the currency of the selected country. For example, in case `country=US`, a value of `105.34` means `$105.34`.
- max_price (integer): Only return product offers with price lower than a certain value. Specified in the currency of the selected country. For example, in case `country=US`, a value of `105.34` means `$105.34`.
- product_condition (string, default: `ALL`, allowed: ALL | NEW | USED | RENEWED | COLLECTIBLE): Return products in a specific condition.
- brand (string): Find products with a specific brand. Multiple brands can be specified as a comma (,) separated list. The brand values can be seen from Amazon's search left filters panel, as seen here.
- seller_id (string): Find products sold by a specific seller (merchant). Multiple sellers can be specified as a comma (,) separated list.
- is_prime (boolean, default: `false`): Only return prime products.
- deals_and_discounts (string, default: `NONE`, allowed: NONE | ALL_DISCOUNTS | TODAYS_DEALS): Return deals and discounts in a specific condition.
- four_stars_and_up (boolean): Return product listings with ratings of 4 stars & up.
- language (string): The language of the results. In case not specified, results will be returned in the default domain language. **Supported languages per country:** `US`: en_US, es_US `AU`: en_AU `BR`: pt_BR `CA`: en_CA, fr_CA `FR`: fr_FR, en_GB `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN `IT`: it_IT, en_GB `MX`: es_MX `NL`: nl_NL, en_GB `SG`: en_SG `ES`: es_ES, pt_PT, en_GB `TR`: tr_TR `AE`: en_AE, ar_AE `GB`: en_GB `JP`: ja_JP, en_US, zh_CN `SA`: ar_AE, en_AE `PL`: pl_PL `SE`: sv_SE, en_GB `BE`: fr_BE, nl_BE, en_GB `EG`: ar_AE, en_AE `ZA`: en_ZA `IE`: en_IE
- additional_filters (string): Any filters available on the Amazon page but not part of this endpoint's parameters. The filter values can be extracted from the rh parameter in the Amazon search URL after applying the filter of interest on the Amazon search results page. Multiple filters are supported and can be separated by comma (,). For example, when searching for science books with the Paperback book format filter selected, the Amazon URL is: https://www.amazon.com/s?k=science+books&rh=p_n_feature_browse-bin%3A2656022011 and the rh parameter value is: `p_n_feature_browse-bin%3A2656022011` To filter for Paperback books, set the value of additional_parameters=p_n_feature_browse-bin%3A2656022011.
- fields (string): A comma separated list of product fields to include in the response (field projection). By default all fields are returned.
Full URL: `https://api.openwebninja.com/realtime-amazon-data/search`

### GET /products-by-category - Product by Category
Get products & offers in a specific Amazon category with pagination support and multiple filters and options such as sort option, price range, product condition filter, and more.
Parameters:
- **category_id** (string, required): The Amazon category for which to return results. The category ID can be obtained from the Amazon category results URL, for example: https://amazon.com/s?node=2858778013 - the Amazon Category ID is `2858778013`. Multiple category values can be separated by comma (e.g. categoryId1,categoryId2).
- page (integer, default: `1`): Page to return.
- country (string, default: `US`, allowed: US | AU | BR | CA | CN | FR | DE | IN | IT | MX | NL | SG | ES | TR | AE | GB | JP | SA | PL | SE | BE | EG | ZA | IE): Sets the Amazon domain, marketplace country, language and currency.
- delivery_country (string): Delivery destination country (ISO 3166-1 alpha-2 code, e.g. `NL`). When set, delivery dates, shipping costs, availability and offers reflect delivery to this country instead of the marketplace's domestic delivery. Defaults to the marketplace country. Only specific `country` / `delivery_country` combinations are supported. Currently supported: `country` = `DE`, `FR`, `IT` or `ES` with `delivery_country` = `NL`. Other combinations return a 400 error. If you need another combination, contact us at support@openwebninja.com and we will look into adding it.
- sort_by (string, default: `RELEVANCE`, allowed: RELEVANCE | LOWEST_PRICE | HIGHEST_PRICE | REVIEWS | NEWEST | BEST_SELLERS): Return the results in a specific sort order.
- min_price (number): Only return product offers with price greater than a certain value. Specified in the currency of the selected country. For example, in case `country=US`, a value of `105.34` means `$105.34`.
- max_price (integer): Only return product offers with price lower than a certain value. Specified in the currency of the selected country. For example, in case `country=US`, a value of `105.34` means `$105.34`.
- product_condition (string, default: `ALL`, allowed: ALL | NEW | USED | RENEWED | COLLECTIBLE): Return products in a specific condition.
- brand (string): Find products with a specific brand. Multiple brands can be specified as a comma (,) separated list. The brand values can be seen from Amazon's search left filters panel, as seen here.
- is_prime (boolean, default: `false`): Only return prime products.
- deals_and_discounts (string, default: `NONE`, allowed: NONE | ALL_DISCOUNTS | TODAYS_DEALS): Return deals and discounts in a specific condition.
- four_stars_and_up (boolean): Return product listings with ratings of 4 stars & up.
- language (string): The language of the results. In case not specified, results will be returned in the default domain language. **Supported languages per country:** `US`: en_US, es_US `AU`: en_AU `BR`: pt_BR `CA`: en_CA, fr_CA `FR`: fr_FR, en_GB `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN `IT`: it_IT, en_GB `MX`: es_MX `NL`: nl_NL, en_GB `SG`: en_SG `ES`: es_ES, pt_PT, en_GB `TR`: tr_TR `AE`: en_AE, ar_AE `GB`: en_GB `JP`: ja_JP, en_US, zh_CN `SA`: ar_AE, en_AE `PL`: pl_PL `SE`: sv_SE, en_GB `BE`: fr_BE, nl_BE, en_GB `EG`: ar_AE, en_AE `ZA`: en_ZA `IE`: en_IE
- additional_filters (string): Any filters available on the Amazon page but not part of this endpoint's parameters. The filter values can be extracted from the rh parameter in the Amazon search URL after applying the filter of interest on the Amazon search results page. Multiple filters are supported and can be separated by comma (,). For example, when searching for science books with the Paperback book format filter selected, the Amazon URL is: https://www.amazon.com/s?k=science+books&rh=p_n_feature_browse-bin%3A2656022011 and the rh parameter value is: `p_n_feature_browse-bin%3A2656022011` To filter for Paperback books, set the value of additional_parameters=p_n_feature_browse-bin%3A2656022011.
- fields (string): A comma separated list of product fields to include in the response (field projection). By default all fields are returned.
Full URL: `https://api.openwebninja.com/realtime-amazon-data/products-by-category`

### GET /product-details - Product Details
Get extensive Amazon product details and information available on the Amazon product page by asin, including title, price data, ratings data, photos, product details (brand, weight, package size, model, etc.) product variations (colors, sizes, flavors, etc), best sellers rank, review insights, buy box and FBA details, and many other data points.
Parameters:
- **asin** (string, required): Product ASIN for which to get details. Supports batching of up to 10 ASINs in a single request, separated by comma. **Billing:** each ASIN is billed as a separate request, so a batch of 10 ASINs counts as 10 requests against the plan quota.
- country (string, default: `US`, allowed: US | AU | BR | CA | CN | FR | DE | IN | IT | MX | NL | SG | ES | TR | AE | GB | JP | SA | PL | SE | BE | EG | ZA | IE): Sets the Amazon domain, marketplace country, language and currency.
- delivery_country (string): Delivery destination country (ISO 3166-1 alpha-2 code, e.g. `NL`). When set, delivery dates, shipping costs, availability and offers reflect delivery to this country instead of the marketplace's domestic delivery. Defaults to the marketplace country. Only specific `country` / `delivery_country` combinations are supported. Currently supported: `country` = `DE`, `FR`, `IT` or `ES` with `delivery_country` = `NL`. Other combinations return a 400 error. If you need another combination, contact us at support@openwebninja.com and we will look into adding it.
- more_info_query (string): A query to search and get more info about the product as part of Product Information, Customer Q&As, and Customer Reviews.
- language (string): The language of the results. In case not specified, results will be returned in the default domain language. **Supported languages per country:** `US`: en_US, es_US `AU`: en_AU `BR`: pt_BR `CA`: en_CA, fr_CA `FR`: fr_FR, en_GB `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN `IT`: it_IT, en_GB `MX`: es_MX `NL`: nl_NL, en_GB `SG`: en_SG `ES`: es_ES, pt_PT, en_GB `TR`: tr_TR `AE`: en_AE, ar_AE `GB`: en_GB `JP`: ja_JP, en_US, zh_CN `SA`: ar_AE, en_AE `PL`: pl_PL `SE`: sv_SE, en_GB `BE`: fr_BE, nl_BE, en_GB `EG`: ar_AE, en_AE `ZA`: en_ZA `IE`: en_IE
- fields (string): A comma separated list of product fields to include in the response (field projection). By default all fields are returned.
Full URL: `https://api.openwebninja.com/realtime-amazon-data/product-details`

### GET /product-reviews - Product Reviews
Get and paginate through product reviews on Amazon.
Parameters:
- **asin** (string, required): Product asin for which to get reviews.
- **cookie** (string, required): A logged-in user cookie to use for fetching product reviews. Include the following cookies for country=US: session-id, ubid-main, x-main, and at-main. For any other country: session-id, ubid-acb{country code}, x-acb{country code}, at-acb{country code}
- country (string, default: `US`, allowed: US | AU | BR | CA | CN | FR | DE | IN | IT | MX | NL | SG | ES | TR | AE | GB | JP | SA | PL | SE | BE | EG | ZA | IE): Sets the Amazon domain, marketplace country, language and currency.
- cursor (string, default: `1`): A cursor used to retrieve the next set of results for pagination. The value for the next page is returned in the "cursor" response field.
- sort_by (string, default: `TOP_REVIEWS`): Return reviews in a specific sort order.
- star_rating (string, default: `ALL`, allowed: ALL | 5_STARS | 4_STARS | 3_STARS | 2_STARS | 1_STARS | POSITIVE | CRITICAL): Only return reviews with a specific star rating or positive / negative sentiment.
- verified_purchases_only (boolean): Only return reviews by reviewers who made a verified purchase.
- images_or_videos_only (boolean): Only return reviews containing images and / or videos.
- current_format_only (boolean): Only return reviews of the current format (product variant - e.g. Color). By default reviews are returned for all product variants
- query (string): Find reviews matching a search query.
- language (string): The language of the results. In case not specified, results will be returned in the default domain language. **Supported languages per country:** `US`: en_US, es_US `AU`: en_AU `BR`: pt_BR `CA`: en_CA, fr_CA `FR`: fr_FR, en_GB `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN `IT`: it_IT, en_GB `MX`: es_MX `NL`: nl_NL, en_GB `SG`: en_SG `ES`: es_ES, pt_PT, en_GB `TR`: tr_TR `AE`: en_AE, ar_AE `GB`: en_GB `JP`: ja_JP, en_US, zh_CN `SA`: ar_AE, en_AE `PL`: pl_PL `SE`: sv_SE, en_GB `BE`: fr_BE, nl_BE, en_GB `EG`: ar_AE, en_AE `ZA`: en_ZA `IE`: en_IE
- fields (string): A comma separated list of product fields to include in the response (field projection). By default all fields are returned.
Full URL: `https://api.openwebninja.com/realtime-amazon-data/product-reviews`

### GET /product-review-details - Product Review Details
Get the details of a specific product review by id
Parameters:
- **review_id** (string, required): The id of the product review for which to get details.
- **cookie** (string, required): A logged-in user cookie to use for fetching product reviews.
- country (string, default: `US`, allowed: US | AU | BR | CA | CN | FR | DE | IN | IT | MX | NL | SG | ES | TR | AE | GB | JP | SA | PL | SE | BE | EG | ZA | IE): Sets the Amazon domain, marketplace country, language and currency.
- language (string): The language of the results. In case not specified, results will be returned in the default domain language. **Supported languages per country:** `US`: en_US, es_US `AU`: en_AU `BR`: pt_BR `CA`: en_CA, fr_CA `FR`: fr_FR, en_GB `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN `IT`: it_IT, en_GB `MX`: es_MX `NL`: nl_NL, en_GB `SG`: en_SG `ES`: es_ES, pt_PT, en_GB `TR`: tr_TR `AE`: en_AE, ar_AE `GB`: en_GB `JP`: ja_JP, en_US, zh_CN `SA`: ar_AE, en_AE `PL`: pl_PL `SE`: sv_SE, en_GB `BE`: fr_BE, nl_BE, en_GB `EG`: ar_AE, en_AE `ZA`: en_ZA `IE`: en_IE
- fields (string): A comma separated list of product fields to include in the response (field projection). By default all fields are returned.
Full URL: `https://api.openwebninja.com/realtime-amazon-data/product-review-details`

### GET /top-product-reviews - Top Product Reviews
Get top product reviews by ASIN from the Amazon product details page.
Parameters:
- **asin** (string, required): Product asin for which to get reviews.
- country (string, default: `US`, allowed: US | AU | BR | CA | CN | FR | DE | IN | IT | MX | NL | SG | ES | TR | AE | GB | JP | SA | PL | SE | BE | EG | ZA | IE): Sets the Amazon domain, marketplace country, language and currency.
- fields (string): A comma separated list of product fields to include in the response (field projection). By default all fields are returned.
- language (string): The language of the results. In case not specified, results will be returned in the default domain language. **Supported languages per country:** `US`: en_US, es_US `AU`: en_AU `BR`: pt_BR `CA`: en_CA, fr_CA `FR`: fr_FR, en_GB `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN `IT`: it_IT, en_GB `MX`: es_MX `NL`: nl_NL, en_GB `SG`: en_SG `ES`: es_ES, pt_PT, en_GB `TR`: tr_TR `AE`: en_AE, ar_AE `GB`: en_GB `JP`: ja_JP, en_US, zh_CN `SA`: ar_AE, en_AE `PL`: pl_PL `SE`: sv_SE, en_GB `BE`: fr_BE, nl_BE, en_GB `EG`: ar_AE, en_AE `ZA`: en_ZA `IE`: en_IE
Full URL: `https://api.openwebninja.com/realtime-amazon-data/top-product-reviews`

### GET /product-offers - Product Offers
Get all Amazon product details as available via the Product Details endpoint with an additional offers array containing product offers (The first offer in the array is the pinned offer returned by the Search endpoint).
Parameters:
- **asin** (string, required): Product ASIN for which to get offers. Supports batching of up to 10 ASINs in a single request, separated by comma. **Billing:** each ASIN is billed as a separate request, so a batch of 10 ASINs counts as 10 requests against the plan quota.
- country (string, default: `US`, allowed: US | AU | BR | CA | CN | FR | DE | IN | IT | MX | NL | SG | ES | TR | AE | GB | JP | SA | PL | SE | BE | EG | ZA | IE): Sets the Amazon domain, marketplace country, language and currency.
- delivery_country (string): Delivery destination country (ISO 3166-1 alpha-2 code, e.g. `NL`). When set, delivery dates, shipping costs, availability and offers reflect delivery to this country instead of the marketplace's domestic delivery. Defaults to the marketplace country. Only specific `country` / `delivery_country` combinations are supported. Currently supported: `country` = `DE`, `FR`, `IT` or `ES` with `delivery_country` = `NL`. Other combinations return a 400 error. If you need another combination, contact us at support@openwebninja.com and we will look into adding it.
- product_condition (string, default: `NEW, USED_LIKE_NEW, USED_VERY_GOOD, USED_GOOD, USED_ACCEPTABLE`): Find products in specific conditions, specified as a comma delimited list of the following values:
- delivery (string, allowed: PRIME_ELIGIBLE | FREE_DELIVERY): Find products with specific delivery option, specified as a comma delimited list of the following values:
- limit (integer, default: `100`): Maximum number of offers to return.
- page (integer, default: `1`): Results page to return.
- language (string): The language of the results. In case not specified, results will be returned in the default domain language. **Supported languages per country:** `US`: en_US, es_US `AU`: en_AU `BR`: pt_BR `CA`: en_CA, fr_CA `FR`: fr_FR, en_GB `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN `IT`: it_IT, en_GB `MX`: es_MX `NL`: nl_NL, en_GB `SG`: en_SG `ES`: es_ES, pt_PT, en_GB `TR`: tr_TR `AE`: en_AE, ar_AE `GB`: en_GB `JP`: ja_JP, en_US, zh_CN `SA`: ar_AE, en_AE `PL`: pl_PL `SE`: sv_SE, en_GB `BE`: fr_BE, nl_BE, en_GB `EG`: ar_AE, en_AE `ZA`: en_ZA `IE`: en_IE
- fields (string): A comma separated list of product fields to include in the response (field projection). By default all fields are returned.
Full URL: `https://api.openwebninja.com/realtime-amazon-data/product-offers`

### GET /seller-profile - Seller Profile
Get Amazon Seller profile details from the Amazon Seller profile page (e.g.
Parameters:
- **seller_id** (string, required): The Amazon Seller ID for which to get seller profile details
- country (string, default: `US`, allowed: US | AU | BR | CA | CN | FR | DE | IN | IT | MX | NL | SG | ES | TR | AE | GB | JP | SA | PL | SE | BE | EG | ZA | IE): Sets the Amazon domain, marketplace country, language and currency.
- language (string): The language of the results. In case not specified, results will be returned in the default domain language. **Supported languages per country:** `US`: en_US, es_US `AU`: en_AU `BR`: pt_BR `CA`: en_CA, fr_CA `FR`: fr_FR, en_GB `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN `IT`: it_IT, en_GB `MX`: es_MX `NL`: nl_NL, en_GB `SG`: en_SG `ES`: es_ES, pt_PT, en_GB `TR`: tr_TR `AE`: en_AE, ar_AE `GB`: en_GB `JP`: ja_JP, en_US, zh_CN `SA`: ar_AE, en_AE `PL`: pl_PL `SE`: sv_SE, en_GB `BE`: fr_BE, nl_BE, en_GB `EG`: ar_AE, en_AE `ZA`: en_ZA `IE`: en_IE
- fields (string): A comma separated list of seller profile fields to include in the response (field projection). By default all fields are returned.
Full URL: `https://api.openwebninja.com/realtime-amazon-data/seller-profile`

### GET /seller-reviews - Seller Reviews
Get and paginate through Amazon Seller reviews / feedback as shown on the Seller profile page (e.g.
Parameters:
- **seller_id** (string, required): The Amazon Seller ID for which to get seller reviews
- country (string, default: `US`, allowed: US | AU | BR | CA | CN | FR | DE | IN | IT | MX | NL | SG | ES | TR | AE | GB | JP | SA | PL | SE | BE | EG | ZA | IE): Sets the Amazon domain, marketplace country, language and currency.
- star_rating (string, default: `ALL`, allowed: ALL | 5_STARS | 4_STARS | 3_STARS | 2_STARS | 1_STARS | POSITIVE | CRITICAL): Only return reviews with a specific star rating or positive / negative sentiment.
- page (integer, default: `1`): The page of seller feedback results to retrieve.
- language (string): The language of the results. In case not specified, results will be returned in the default domain language. **Supported languages per country:** `US`: en_US, es_US `AU`: en_AU `BR`: pt_BR `CA`: en_CA, fr_CA `FR`: fr_FR, en_GB `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN `IT`: it_IT, en_GB `MX`: es_MX `NL`: nl_NL, en_GB `SG`: en_SG `ES`: es_ES, pt_PT, en_GB `TR`: tr_TR `AE`: en_AE, ar_AE `GB`: en_GB `JP`: ja_JP, en_US, zh_CN `SA`: ar_AE, en_AE `PL`: pl_PL `SE`: sv_SE, en_GB `BE`: fr_BE, nl_BE, en_GB `EG`: ar_AE, en_AE `ZA`: en_ZA `IE`: en_IE
- fields (string): A comma separated list of seller review fields to include in the response (field projection). By default all fields are returned.
Full URL: `https://api.openwebninja.com/realtime-amazon-data/seller-reviews`

### GET /seller-products - Seller Products
Get and paginate through the products sold by an Amazon Seller
Parameters:
- **seller_id** (string, required): The Amazon Seller ID for which to get seller product listings
- country (string, default: `US`, allowed: US | AU | BR | CA | CN | FR | DE | IN | IT | MX | NL | SG | ES | TR | AE | GB | JP | SA | PL | SE | BE | EG | ZA | IE): Sets the Amazon domain, marketplace country, language and currency.
- delivery_country (string): Delivery destination country (ISO 3166-1 alpha-2 code, e.g. `NL`). When set, delivery dates, shipping costs, availability and offers reflect delivery to this country instead of the marketplace's domestic delivery. Defaults to the marketplace country. Only specific `country` / `delivery_country` combinations are supported. Currently supported: `country` = `DE`, `FR`, `IT` or `ES` with `delivery_country` = `NL`. Other combinations return a 400 error. If you need another combination, contact us at support@openwebninja.com and we will look into adding it.
- page (integer, default: `1`): The page of seller products results to retrieve Seller products result page to retrieve.
- sort_by (string, default: `RELEVANCE`, allowed: RELEVANCE | LOWEST_PRICE | HIGHEST_PRICE | REVIEWS | NEWEST | BEST_SELLERS): Return the results in a specific sort order.
- language (string): The language of the results. In case not specified, results will be returned in the default domain language. **Supported languages per country:** `US`: en_US, es_US `AU`: en_AU `BR`: pt_BR `CA`: en_CA, fr_CA `FR`: fr_FR, en_GB `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN `IT`: it_IT, en_GB `MX`: es_MX `NL`: nl_NL, en_GB `SG`: en_SG `ES`: es_ES, pt_PT, en_GB `TR`: tr_TR `AE`: en_AE, ar_AE `GB`: en_GB `JP`: ja_JP, en_US, zh_CN `SA`: ar_AE, en_AE `PL`: pl_PL `SE`: sv_SE, en_GB `BE`: fr_BE, nl_BE, en_GB `EG`: ar_AE, en_AE `ZA`: en_ZA `IE`: en_IE
- fields (string): A comma separated list of seller product fields to include in the response (field projection). By default all fields are returned.
Full URL: `https://api.openwebninja.com/realtime-amazon-data/seller-products`

### GET /best-sellers - Best Sellers
Get Amazon Best Sellers, including prices, ratings, rank and more data points available on Amazon Best Sellers listings.
Parameters:
- **category** (string, required): Best sellers category to return products for. Supports top level best sellers categories (e.g. software). In addition, subcategories / category path can be specified as well, separated by / (e.g. software/229535) - this can be seen in best sellers URLs, e.g. https://www.amazon.com/Best-Sellers-Software-Business-Office/zgbs/software/229535.
- type (string, default: `BEST_SELLERS`, allowed: BEST_SELLERS | GIFT_IDEAS | MOST_WISHED_FOR | MOVERS_AND_SHAKERS | NEW_RELEASES): Type of Best Seller list to return.
- page (integer, default: `1`): Page to return.
- country (string, default: `US`, allowed: US | AU | BR | CA | CN | FR | DE | IN | IT | MX | NL | SG | ES | TR | AE | GB | JP | SA | PL | SE | BE | EG | ZA | IE): Sets the Amazon domain, marketplace country, language and currency.
- delivery_country (string): Delivery destination country (ISO 3166-1 alpha-2 code, e.g. `NL`). When set, delivery dates, shipping costs, availability and offers reflect delivery to this country instead of the marketplace's domestic delivery. Defaults to the marketplace country. Only specific `country` / `delivery_country` combinations are supported. Currently supported: `country` = `DE`, `FR`, `IT` or `ES` with `delivery_country` = `NL`. Other combinations return a 400 error. If you need another combination, contact us at support@openwebninja.com and we will look into adding it.
- language (string): The language of the results. In case not specified, results will be returned in the default domain language. **Supported languages per country:** `US`: en_US, es_US `AU`: en_AU `BR`: pt_BR `CA`: en_CA, fr_CA `FR`: fr_FR, en_GB `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN `IT`: it_IT, en_GB `MX`: es_MX `NL`: nl_NL, en_GB `SG`: en_SG `ES`: es_ES, pt_PT, en_GB `TR`: tr_TR `AE`: en_AE, ar_AE `GB`: en_GB `JP`: ja_JP, en_US, zh_CN `SA`: ar_AE, en_AE `PL`: pl_PL `SE`: sv_SE, en_GB `BE`: fr_BE, nl_BE, en_GB `EG`: ar_AE, en_AE `ZA`: en_ZA `IE`: en_IE
- fields (string): A comma separated list of product fields to include in the response (field projection). By default all fields are returned.
Full URL: `https://api.openwebninja.com/realtime-amazon-data/best-sellers`

### GET /deals-v2 - Deals
Get Amazon Deals (Today's Deals / Top Deals, Best Deals, and Lightning Deals) with support for all deal types, filters, and options available on Amazon.
Parameters:
- country (string, default: `US`, allowed: US | AU | BR | CA | CN | FR | DE | IN | IT | MX | NL | SG | ES | TR | AE | GB | JP | SA | PL | SE | BE | EG | ZA | IE): Sets the Amazon domain, marketplace country, language and currency.
- delivery_country (string): Delivery destination country (ISO 3166-1 alpha-2 code, e.g. `NL`). When set, delivery dates, shipping costs, availability and offers reflect delivery to this country instead of the marketplace's domestic delivery. Defaults to the marketplace country. Only specific `country` / `delivery_country` combinations are supported. Currently supported: `country` = `DE`, `FR`, `IT` or `ES` with `delivery_country` = `NL`. Other combinations return a 400 error. If you need another combination, contact us at support@openwebninja.com and we will look into adding it.
- offset (string): Number of results to skip / index to start from (for pagination). Works with multiples of 30 (like on Amazons deals page) - 0, 30, 60, 90, etc.
- categories (string): Return deals with products in specific categories / departments. Multiple categories can be specified as a comma (,) separated list. Numeric category id's can be found in the URL after selecting a specific category on https://www.amazon.com/deals.
- min_product_star_rating (string, default: `ALL`, allowed: ALL | 1 | 2 | 3 | 4): Return deals with products star rating greater than a specific value
- price_range (string, default: `ALL`, allowed: ALL | 1 | 2 | 3 | 4 | 5): Return deals with price within a specific price range. 1 is lowest price range shown on Amazon (e.g. Under $25) while 5 is the highest price range (e.g. $200 & Above).
- discount_range (string, default: `ALL`, allowed: ALL | 1 | 2 | 3 | 4 | 5): Return deals with discount within a specific discount range. 1 is lowest discount range shown on Amazon (e.g. 10% off or more) while 5 is the highest discount range (e.g. 70% off or more).
- brands (string): Return deals with products by specific brands. Multiple brands can be specified separated by comma (,). In addition, brand names can be found under the Brand filter on the filter/refinements panel on https://www.amazon.com/deals (when applicable).
- prime_early_access (boolean): Only return prime early access deals.
- prime_exclusive (boolean): Only return prime exclusive deals.
- lightning_deals (boolean): Only return lightning deals
- language (string): The language of the results. In case not specified, results will be returned in the default domain language. **Supported languages per country:** `US`: en_US, es_US `AU`: en_AU `BR`: pt_BR `CA`: en_CA, fr_CA `FR`: fr_FR, en_GB `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN `IT`: it_IT, en_GB `MX`: es_MX `NL`: nl_NL, en_GB `SG`: en_SG `ES`: es_ES, pt_PT, en_GB `TR`: tr_TR `AE`: en_AE, ar_AE `GB`: en_GB `JP`: ja_JP, en_US, zh_CN `SA`: ar_AE, en_AE `PL`: pl_PL `SE`: sv_SE, en_GB `BE`: fr_BE, nl_BE, en_GB `EG`: ar_AE, en_AE `ZA`: en_ZA `IE`: en_IE
- fields (string): A comma separated list of deal fields to include in the response (field projection). By default all fields are returned.
Full URL: `https://api.openwebninja.com/realtime-amazon-data/deals-v2`

### GET /deal-products - Deal Products
Get the products of a specific deal by Deal ID.
Parameters:
- **deal_id** (string, required): Deal ID of the deal to fetch
- country (string, default: `US`, allowed: US | AU | BR | CA | CN | FR | DE | IN | IT | MX | NL | SG | ES | TR | AE | GB | JP | SA | PL | SE | BE | EG | ZA | IE): Sets the Amazon domain, marketplace country, language and currency.
- delivery_country (string): Delivery destination country (ISO 3166-1 alpha-2 code, e.g. `NL`). When set, delivery dates, shipping costs, availability and offers reflect delivery to this country instead of the marketplace's domestic delivery. Defaults to the marketplace country. Only specific `country` / `delivery_country` combinations are supported. Currently supported: `country` = `DE`, `FR`, `IT` or `ES` with `delivery_country` = `NL`. Other combinations return a 400 error. If you need another combination, contact us at support@openwebninja.com and we will look into adding it.
- sort_by (string, default: `FEATURED`, allowed: FEATURED | LOWEST_PRICE | HIGHEST_PRICE | REVIEWS | NEWEST | BEST_SELLERS): Return products in a specific order.
- page (integer, default: `1`): Results page to return.
- language (string): The language of the results. In case not specified, results will be returned in the default domain language. **Supported languages per country:** `US`: en_US, es_US `AU`: en_AU `BR`: pt_BR `CA`: en_CA, fr_CA `FR`: fr_FR, en_GB `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN `IT`: it_IT, en_GB `MX`: es_MX `NL`: nl_NL, en_GB `SG`: en_SG `ES`: es_ES, pt_PT, en_GB `TR`: tr_TR `AE`: en_AE, ar_AE `GB`: en_GB `JP`: ja_JP, en_US, zh_CN `SA`: ar_AE, en_AE `PL`: pl_PL `SE`: sv_SE, en_GB `BE`: fr_BE, nl_BE, en_GB `EG`: ar_AE, en_AE `ZA`: en_ZA `IE`: en_IE
- fields (string): A comma separated list of deal product fields to include in the response (field projection). By default all fields are returned.
Full URL: `https://api.openwebninja.com/realtime-amazon-data/deal-products`

### GET /promo-code-details - Promo Code Details
Get the products offered by an Amazon promo code.
Parameters:
- **promo_code** (string, required): Promo code for which to get products. The promo code can be extracted from the /promocode Amazon URL. For example the promo code for https://www.amazon.com/promocode/A31M10S4V50SOU is A31M10S4V50SOU.
- country (string, default: `US`, allowed: US | AU | BR | CA | CN | FR | DE | IN | IT | MX | NL | SG | ES | TR | AE | GB | JP | SA | PL | SE | BE | EG | ZA | IE): Sets the Amazon domain, marketplace country, language and currency.
- delivery_country (string): Delivery destination country (ISO 3166-1 alpha-2 code, e.g. `NL`). When set, delivery dates, shipping costs, availability and offers reflect delivery to this country instead of the marketplace's domestic delivery. Defaults to the marketplace country. Only specific `country` / `delivery_country` combinations are supported. Currently supported: `country` = `DE`, `FR`, `IT` or `ES` with `delivery_country` = `NL`. Other combinations return a 400 error. If you need another combination, contact us at support@openwebninja.com and we will look into adding it.
- language (string): The language of the results. In case not specified, results will be returned in the default domain language. **Supported languages per country:** `US`: en_US, es_US `AU`: en_AU `BR`: pt_BR `CA`: en_CA, fr_CA `FR`: fr_FR, en_GB `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN `IT`: it_IT, en_GB `MX`: es_MX `NL`: nl_NL, en_GB `SG`: en_SG `ES`: es_ES, pt_PT, en_GB `TR`: tr_TR `AE`: en_AE, ar_AE `GB`: en_GB `JP`: ja_JP, en_US, zh_CN `SA`: ar_AE, en_AE `PL`: pl_PL `SE`: sv_SE, en_GB `BE`: fr_BE, nl_BE, en_GB `EG`: ar_AE, en_AE `ZA`: en_ZA `IE`: en_IE
Full URL: `https://api.openwebninja.com/realtime-amazon-data/promo-code-details`

### GET /influencer-profile - Influencer Profile
Get Amazon Influencer profile details from the Amazon Influencer store page *(e.g.
Parameters:
- **influencer_name** (string, required): The Amazon Influencer name for which to get profile details
- country (string, default: `US`, allowed: US | AU | BR | CA | CN | FR | DE | IN | IT | MX | NL | SG | ES | TR | AE | GB | JP | SA | PL | SE | BE | EG | ZA | IE): Sets the Amazon domain, marketplace country, language and currency.
- fields (string): A comma separated list of influencer profile fields to include in the response (field projection). By default all fields are returned.
- language (string): The language of the results. In case not specified, results will be returned in the default domain language. **Supported languages per country:** `US`: en_US, es_US `AU`: en_AU `BR`: pt_BR `CA`: en_CA, fr_CA `FR`: fr_FR, en_GB `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN `IT`: it_IT, en_GB `MX`: es_MX `NL`: nl_NL, en_GB `SG`: en_SG `ES`: es_ES, pt_PT, en_GB `TR`: tr_TR `AE`: en_AE, ar_AE `GB`: en_GB `JP`: ja_JP, en_US, zh_CN `SA`: ar_AE, en_AE `PL`: pl_PL `SE`: sv_SE, en_GB `BE`: fr_BE, nl_BE, en_GB `EG`: ar_AE, en_AE `ZA`: en_ZA `IE`: en_IE
Full URL: `https://api.openwebninja.com/realtime-amazon-data/influencer-profile`

### GET /influencer-posts - Influencer Posts
Get all Amazon Influencer posts with pagination support.
Parameters:
- **influencer_name** (string, required): The Amazon Influencer name for which to get posts
- country (string, default: `US`, allowed: US | AU | BR | CA | CN | FR | DE | IN | IT | MX | NL | SG | ES | TR | AE | GB | JP | SA | PL | SE | BE | EG | ZA | IE): Sets the Amazon domain, marketplace country, language and currency.
- scope (string, default: `ALL`, allowed: ALL | IDEA_LISTS | PHOTOS | VIDEOS): Return the results in a specific scope.
- query (string): Find posts matching a search query.
- cursor (string): A cursor to get the next set of results, it can be used for for paging purposes. **Note:** the cursor value for the next set of results is returned by this endpoint under data.cursor.
- limit (integer, default: `20`): Maximum number of posts to return.
- language (string): The language of the results. In case not specified, results will be returned in the default domain language. **Supported languages per country:** `US`: en_US, es_US `AU`: en_AU `BR`: pt_BR `CA`: en_CA, fr_CA `FR`: fr_FR, en_GB `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN `IT`: it_IT, en_GB `MX`: es_MX `NL`: nl_NL, en_GB `SG`: en_SG `ES`: es_ES, pt_PT, en_GB `TR`: tr_TR `AE`: en_AE, ar_AE `GB`: en_GB `JP`: ja_JP, en_US, zh_CN `SA`: ar_AE, en_AE `PL`: pl_PL `SE`: sv_SE, en_GB `BE`: fr_BE, nl_BE, en_GB `EG`: ar_AE, en_AE `ZA`: en_ZA `IE`: en_IE
- fields (string): A comma separated list of influencer post fields to include in the response (field projection). By default all fields are returned.
Full URL: `https://api.openwebninja.com/realtime-amazon-data/influencer-posts`

### GET /influencer-post-products - Influencer Post Products
Get the list of products related to a "List" type post by Post ID.
Parameters:
- **influencer_name** (string, required)
- **post_id** (string, required): Influencer Post ID (e.g. amzn1.ideas.1N84PQ3CI4NW0) of the list post for which to get product items (only posts with post_type=List are allowed).
- cursor (string): Set the cursor value from the response of the previous call to get the next results page.
- language (string): The language of the results. In case not specified, results will be returned in the default domain language. **Supported languages per country:** `US`: en_US, es_US `AU`: en_AU `BR`: pt_BR `CA`: en_CA, fr_CA `FR`: fr_FR, en_GB `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN `IT`: it_IT, en_GB `MX`: es_MX `NL`: nl_NL, en_GB `SG`: en_SG `ES`: es_ES, pt_PT, en_GB `TR`: tr_TR `AE`: en_AE, ar_AE `GB`: en_GB `JP`: ja_JP, en_US, zh_CN `SA`: ar_AE, en_AE `PL`: pl_PL `SE`: sv_SE, en_GB `BE`: fr_BE, nl_BE, en_GB `EG`: ar_AE, en_AE `ZA`: en_ZA `IE`: en_IE
Full URL: `https://api.openwebninja.com/realtime-amazon-data/influencer-post-products`

### GET /asin-to-gtin - ASIN to GTIN
Convert an Amazon ASIN to GTIN / EAN / UPS identifiers.
Parameters:
- **asin** (string, required): Amazon product ASIN to convert.
- country (string, default: `US`, allowed: US | AU | BR | CA | CN | FR | DE | IN | IT | MX | NL | SG | ES | TR | AE | GB | JP | SA | PL | SE | BE | EG | ZA | IE): Sets the Amazon domain, marketplace country, language and currency.
Full URL: `https://api.openwebninja.com/realtime-amazon-data/asin-to-gtin`

### GET /gtin-to-asin - GTIN to ASIN
Find Amazon products by GTIN, EAN, UPC, or ISBN.
Parameters:
- **product_identifier** (string, required): Product identifier to look up on Amazon. Supports GTIN, EAN-13, UPC, or ISBN.
- country (string, default: `US`, allowed: US | AU | BR | CA | CN | FR | DE | IN | IT | MX | NL | SG | ES | TR | AE | GB | JP | SA | PL | SE | BE | EG | ZA | IE): Sets the Amazon domain, marketplace country, language and currency.
Full URL: `https://api.openwebninja.com/realtime-amazon-data/gtin-to-asin`

### GET /product-category-list - Product Category List
Get Amazon product categories per country / Amazon domain (for use with the "category_id" parameter of the Product Search only).
Parameters:
- country (string, default: `US`, allowed: US | AU | BR | CA | CN | FR | DE | IN | IT | MX | NL | SG | ES | TR | AE | GB | JP | SA | PL | SE | BE | EG | ZA | IE): Sets the Amazon domain, marketplace country, language and currency.
Full URL: `https://api.openwebninja.com/realtime-amazon-data/product-category-list`

### GET /scrape-by-url - Scrape By URL
Scrape any Amazon page by providing a full URL.
Parameters:
- **url** (string, required): The full Amazon URL to scrape. The API automatically detects the page type and returns the appropriate parsed data. **Supported page types:** - Product details (e.g. `https://www.amazon.com/dp/B0D1XD1ZV3`) - Product reviews (e.g. `https://www.amazon.com/product-reviews/B0D1XD1ZV3`) - Deals (e.g. `https://www.amazon.com/deals`) - Best sellers (e.g. `https://www.amazon.com/Best-Sellers/zgbs`) - Seller profile (e.g. `https://www.amazon.com/sp?seller=A1D09S7Q0OD6TH`) - Seller products - Search results - Amazon Haul
- country (string, default: `US`, allowed: US | AU | BR | CA | CN | FR | DE | IN | IT | MX | NL | SG | ES | TR | AE | GB | JP | SA | PL | SE | BE | EG | ZA | IE): Sets the Amazon domain, marketplace country, language and currency.
- delivery_country (string): Delivery destination country (ISO 3166-1 alpha-2 code, e.g. `NL`). When set, delivery dates, shipping costs, availability and offers reflect delivery to this country instead of the marketplace's domestic delivery. Defaults to the marketplace country. Only specific `country` / `delivery_country` combinations are supported. Currently supported: `country` = `DE`, `FR`, `IT` or `ES` with `delivery_country` = `NL`. Other combinations return a 400 error. If you need another combination, contact us at support@openwebninja.com and we will look into adding it.
- language (string): The language of the results. In case not specified, results will be returned in the default domain language. **Supported languages per country:** `US`: en_US, es_US `AU`: en_AU `BR`: pt_BR `CA`: en_CA, fr_CA `FR`: fr_FR, en_GB `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN `IT`: it_IT, en_GB `MX`: es_MX `NL`: nl_NL, en_GB `SG`: en_SG `ES`: es_ES, pt_PT, en_GB `TR`: tr_TR `AE`: en_AE, ar_AE `GB`: en_GB `JP`: ja_JP, en_US, zh_CN `SA`: ar_AE, en_AE `PL`: pl_PL `SE`: sv_SE, en_GB `BE`: fr_BE, nl_BE, en_GB `EG`: ar_AE, en_AE `ZA`: en_ZA `IE`: en_IE
- cookie (string): Custom cookie string to use when scraping the URL.
- return_html (string, default: `false`, allowed: true | false): Include the raw HTML of the scraped page in the response. **Default:** `false`
Full URL: `https://api.openwebninja.com/realtime-amazon-data/scrape-by-url`

## Base URL and Authentication

- Base URL: `https://api.openwebninja.com/realtime-amazon-data`
- Auth: API key in the `x-api-key` header. Get a key by subscribing (free tier available) at https://app.openwebninja.com/api/realtime-amazon-data

## Topics

amazon data api, amazon product api, asin data api, amazon reviews api, amazon offers api, amazon best sellers api, amazon deals api, amazon seller api, product data api, price tracking api, ecommerce data api, amazon scraper api

## Links

- API page: https://www.openwebninja.com/api/real-time-amazon-data
- Get an API key / subscribe: https://app.openwebninja.com/api/realtime-amazon-data
- Pricing & plans: https://app.openwebninja.com/api/realtime-amazon-data/pricing
- Website: https://www.openwebninja.com
- OpenAPI spec: https://openwebninja.s3.us-east-1.amazonaws.com/portal/openapi/realtime_amazon_data.yaml
- Support: support@openwebninja.com

_Last updated: 2026-10-09_