# Real-Time Amazon Data API (`openweb-ninja/real-time-amazon-data`) Actor

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.

- **URL**: https://apify.com/openweb-ninja/real-time-amazon-data.md
- **Developed by:** [OpenWeb Ninja](https://apify.com/openweb-ninja) (community)
- **Categories:** E-commerce, Developer tools
- **Security:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.75 / 1,000 api requests

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Real-Time Amazon Data API

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.

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.

This actor runs the same Real-Time Amazon Data API that developers use on RapidAPI and OpenWeb Ninja, with the same endpoints, parameters and output.

### What you can do with it

- Monitor prices, offers and the buy box for any ASIN, in any marketplace
- Research products, categories and best sellers for e-commerce analytics
- Collect product reviews and ratings for sentiment analysis
- Track deals, sellers and influencer storefronts
- Power price comparison, repricing and arbitrage tools

### Endpoints

Pick the endpoint in the **Endpoint** field. Each run makes one call to that endpoint and writes its results to the dataset.

#### Product Search

`GET /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.

| Parameter | Required | Description |
|---|---|---|
| `query` | Yes | Search query (supports both free-form text queries or a product asin). |
| `page` | No | Results page to return. Default: `1`. |
| `country` | No | Sets the Amazon domain, marketplace country, language and currency. Values: `US`, `AU`, `BR`, `CA`, `CN`, `FR`, `DE`, `IN`, `IT`, `MX`, `NL`, `SG`, `ES`, `TR`, `AE`, `GB`, `JP`, `SA`, `PL`, `SE`, `BE`, `EG`, `ZA`, `IE`. Default: `US`. |
| `delivery_country` | No | 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. |
| `delivery_zipcode` | No | Postal / ZIP code within the `country` marketplace, in its usual format, used as the delivery address so delivery dates, costs, availability and offers reflect it. An invalid zip code returns a 400 error. |
| `sort_by` | No | Return the results in a specific sort order. Values: `RELEVANCE`, `LOWEST_PRICE`, `HIGHEST_PRICE`, `REVIEWS`, `NEWEST`, `BEST_SELLERS`. Default: `RELEVANCE`. |
| `category_id` | No | 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. Default: `aps (All Departments)`. |
| `category` | No | 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`. |
| `min_price` | No | 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` | No | 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` | No | Return products in a specific condition. Values: `ALL`, `NEW`, `USED`, `RENEWED`, `COLLECTIBLE`. Default: `ALL`. |
| `brand` | No | 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` | No | Find products sold by a specific seller (merchant). Multiple sellers can be specified as a comma (,) separated list. |
| `is_prime` | No | Only return prime products. Default: `false`. |
| `deals_and_discounts` | No | Return deals and discounts in a specific condition. Values: `NONE`, `ALL_DISCOUNTS`, `TODAYS_DEALS`. Default: `NONE`. |
| `four_stars_and_up` | No | Return product listings with ratings of 4 stars & up. |
| `language` | No | The language of the results. In case not specified, results will be returned in the default domain language. |
| `additional_filters` | No | Any filters available on the Amazon page but not part of this endpoint's parameters. |
| `fields` | No | A comma separated list of product fields to include in the response (field projection). By default all fields are returned. |

#### Products by Category

`GET /products-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.

| Parameter | Required | Description |
|---|---|---|
| `category_id` | Yes | 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`. |
| `page` | No | Page to return. Default: `1`. |
| `country` | No | Sets the Amazon domain, marketplace country, language and currency. Values: `US`, `AU`, `BR`, `CA`, `CN`, `FR`, `DE`, `IN`, `IT`, `MX`, `NL`, `SG`, `ES`, `TR`, `AE`, `GB`, `JP`, `SA`, `PL`, `SE`, `BE`, `EG`, `ZA`, `IE`. Default: `US`. |
| `delivery_country` | No | 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. |
| `delivery_zipcode` | No | Postal / ZIP code within the `country` marketplace, in its usual format, used as the delivery address so delivery dates, costs, availability and offers reflect it. An invalid zip code returns a 400 error. |
| `sort_by` | No | Return the results in a specific sort order. Values: `RELEVANCE`, `LOWEST_PRICE`, `HIGHEST_PRICE`, `REVIEWS`, `NEWEST`, `BEST_SELLERS`. Default: `RELEVANCE`. |
| `min_price` | No | 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` | No | 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` | No | Return products in a specific condition. Values: `ALL`, `NEW`, `USED`, `RENEWED`, `COLLECTIBLE`. Default: `ALL`. |
| `brand` | No | 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` | No | Only return prime products. Default: `false`. |
| `deals_and_discounts` | No | Return deals and discounts in a specific condition. Values: `NONE`, `ALL_DISCOUNTS`, `TODAYS_DEALS`. Default: `NONE`. |
| `four_stars_and_up` | No | Return product listings with ratings of 4 stars & up. |
| `language` | No | The language of the results. In case not specified, results will be returned in the default domain language. |
| `additional_filters` | No | Any filters available on the Amazon page but not part of this endpoint's parameters. |
| `fields` | No | A comma separated list of product fields to include in the response (field projection). By default all fields are returned. |

#### Product Details

`GET /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. Here's an example product page: <https://www.amazon.com/dp/B0CMZFCQ6D>. Set `include_offers` to `true` to also get the product's offers from all sellers in the same response (billed as 2 requests per ASIN).

| Parameter | Required | Description |
|---|---|---|
| `asin` | Yes | Product ASIN for which to get details. Supports batching of up to 10 ASINs in a single request, separated by comma. |
| `country` | No | Sets the Amazon domain, marketplace country, language and currency. Values: `US`, `AU`, `BR`, `CA`, `CN`, `FR`, `DE`, `IN`, `IT`, `MX`, `NL`, `SG`, `ES`, `TR`, `AE`, `GB`, `JP`, `SA`, `PL`, `SE`, `BE`, `EG`, `ZA`, `IE`. Default: `US`. |
| `delivery_country` | No | 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. |
| `delivery_zipcode` | No | Postal / ZIP code within the `country` marketplace, in its usual format, used as the delivery address so delivery dates, costs and availability reflect it. |
| `more_info_query` | No | A query to search and get more info about the product as part of Product Information, Customer Q\&As, and Customer Reviews. |
| `include_offers` | No | Also return the product's offers from all sellers as `product_offers`, with the same offer fields as the Product Offers endpoint (first page of offers, all conditions). When set, each ASIN is billed as 2 requests. Default: `false`. |
| `language` | No | The language of the results. In case not specified, results will be returned in the default domain language. |
| `fields` | No | A comma separated list of product fields to include in the response (field projection). By default all fields are returned. |

#### Product Offers

`GET /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). Supports pagination using the page and limit parameters.

| Parameter | Required | Description |
|---|---|---|
| `asin` | Yes | Product ASIN for which to get offers. Supports batching of up to 10 ASINs in a single request, separated by comma. |
| `country` | No | Sets the Amazon domain, marketplace country, language and currency. Values: `US`, `AU`, `BR`, `CA`, `CN`, `FR`, `DE`, `IN`, `IT`, `MX`, `NL`, `SG`, `ES`, `TR`, `AE`, `GB`, `JP`, `SA`, `PL`, `SE`, `BE`, `EG`, `ZA`, `IE`. Default: `US`. |
| `delivery_country` | No | 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. |
| `delivery_zipcode` | No | Postal / ZIP code within the `country` marketplace, in its usual format, used as the delivery address so delivery dates, costs, availability and offers reflect it. An invalid zip code returns a 400 error. |
| `product_condition` | No | Find products in specific conditions (comma separated). Default: `NEW, USED_LIKE_NEW, USED_VERY_GOOD, USED_GOOD, USED_ACCEPTABLE`. |
| `delivery` | No | Find products with specific delivery option (comma separated). Values: `PRIME_ELIGIBLE`, `FREE_DELIVERY`. |
| `limit` | No | Maximum number of offers to return. Default: `100`. |
| `page` | No | Results page to return. Default: `1`. |
| `language` | No | The language of the results. In case not specified, results will be returned in the default domain language. |
| `fields` | No | A comma separated list of product fields to include in the response (field projection). By default all fields are returned. |

#### Product Reviews

`GET /product-reviews`

Get and paginate through product reviews on Amazon. Each page contains up to 10 reviews.

| Parameter | Required | Description |
|---|---|---|
| `asin` | Yes | Product asin for which to get reviews. |
| `cookie` | Yes | 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. |
| `country` | No | Sets the Amazon domain, marketplace country, language and currency. Values: `US`, `AU`, `BR`, `CA`, `CN`, `FR`, `DE`, `IN`, `IT`, `MX`, `NL`, `SG`, `ES`, `TR`, `AE`, `GB`, `JP`, `SA`, `PL`, `SE`, `BE`, `EG`, `ZA`, `IE`. Default: `US`. |
| `cursor` | No | 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. Default: `1`. |
| `sort_by` | No | Return reviews in a specific sort order. Default: `TOP_REVIEWS`. |
| `star_rating` | No | Only return reviews with a specific star rating or positive / negative sentiment. Values: `ALL`, `5_STARS`, `4_STARS`, `3_STARS`, `2_STARS`, `1_STARS`, `POSITIVE`, `CRITICAL`. Default: `ALL`. |
| `verified_purchases_only` | No | Only return reviews by reviewers who made a verified purchase. |
| `images_or_videos_only` | No | Only return reviews containing images and / or videos. |
| `current_format_only` | No | Only return reviews of the current format (product variant - e.g. Color). By default reviews are returned for all product variants |
| `query` | No | Find reviews matching a search query. |
| `language` | No | The language of the results. In case not specified, results will be returned in the default domain language. |
| `fields` | No | A comma separated list of product fields to include in the response (field projection). By default all fields are returned. |

#### Product Review Details

`GET /product-review-details`

Get the details of a specific product review by id

| Parameter | Required | Description |
|---|---|---|
| `review_id` | Yes | The id of the product review for which to get details. |
| `cookie` | Yes | A logged-in user cookie to use for fetching product reviews. |
| `country` | No | Sets the Amazon domain, marketplace country, language and currency. Values: `US`, `AU`, `BR`, `CA`, `CN`, `FR`, `DE`, `IN`, `IT`, `MX`, `NL`, `SG`, `ES`, `TR`, `AE`, `GB`, `JP`, `SA`, `PL`, `SE`, `BE`, `EG`, `ZA`, `IE`. Default: `US`. |
| `language` | No | The language of the results. In case not specified, results will be returned in the default domain language. |
| `fields` | No | A comma separated list of product fields to include in the response (field projection). By default all fields are returned. |

#### Top Product Reviews

`GET /top-product-reviews`

Get top product reviews by ASIN from the Amazon product details page.

| Parameter | Required | Description |
|---|---|---|
| `asin` | Yes | Product asin for which to get reviews. |
| `country` | No | Sets the Amazon domain, marketplace country, language and currency. Values: `US`, `AU`, `BR`, `CA`, `CN`, `FR`, `DE`, `IN`, `IT`, `MX`, `NL`, `SG`, `ES`, `TR`, `AE`, `GB`, `JP`, `SA`, `PL`, `SE`, `BE`, `EG`, `ZA`, `IE`. Default: `US`. |
| `fields` | No | A comma separated list of product fields to include in the response (field projection). By default all fields are returned. |
| `language` | No | The language of the results. In case not specified, results will be returned in the default domain language. |

#### Scrape By URL

`GET /scrape-by-url`

Scrape any Amazon page by providing a full URL. The API automatically detects the page type (product details, product reviews, deals, best sellers, seller profile, seller products, search results, etc.) and returns parsed, structured data accordingly.

| Parameter | Required | Description |
|---|---|---|
| `url` | Yes | 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. |
| `country` | No | Sets the Amazon domain, marketplace country, language and currency. Values: `US`, `AU`, `BR`, `CA`, `CN`, `FR`, `DE`, `IN`, `IT`, `MX`, `NL`, `SG`, `ES`, `TR`, `AE`, `GB`, `JP`, `SA`, `PL`, `SE`, `BE`, `EG`, `ZA`, `IE`. Default: `US`. |
| `delivery_country` | No | 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. |
| `delivery_zipcode` | No | Postal / ZIP code within the `country` marketplace, in its usual format, used as the delivery address so delivery dates, costs, availability and offers reflect it. An invalid zip code returns a 400 error. |
| `language` | No | The language of the results. In case not specified, results will be returned in the default domain language. |
| `cookie` | No | Custom cookie string to use when scraping the URL. |
| `return_html` | No | Include the raw HTML of the scraped page in the response. **Default:** `false` Values: `true`, `false`. Default: `false`. |

#### Seller Profile

`GET /seller-profile`

Get Amazon Seller profile details from the Amazon Seller profile page (e.g. https://www.amazon.com/sp?seller=A1D09S7Q0OD6TH).

| Parameter | Required | Description |
|---|---|---|
| `seller_id` | Yes | The Amazon Seller ID for which to get seller profile details |
| `country` | No | Sets the Amazon domain, marketplace country, language and currency. Values: `US`, `AU`, `BR`, `CA`, `CN`, `FR`, `DE`, `IN`, `IT`, `MX`, `NL`, `SG`, `ES`, `TR`, `AE`, `GB`, `JP`, `SA`, `PL`, `SE`, `BE`, `EG`, `ZA`, `IE`. Default: `US`. |
| `language` | No | The language of the results. In case not specified, results will be returned in the default domain language. |
| `fields` | No | A comma separated list of seller profile fields to include in the response (field projection). By default all fields are returned. |

#### Seller Reviews

`GET /seller-reviews`

Get and paginate through Amazon Seller reviews / feedback as shown on the Seller profile page  (e.g. https://www.amazon.com/sp?seller=A1D09S7Q0OD6TH). Each page contains up to 5 reviews.

| Parameter | Required | Description |
|---|---|---|
| `seller_id` | Yes | The Amazon Seller ID for which to get seller reviews |
| `country` | No | Sets the Amazon domain, marketplace country, language and currency. Values: `US`, `AU`, `BR`, `CA`, `CN`, `FR`, `DE`, `IN`, `IT`, `MX`, `NL`, `SG`, `ES`, `TR`, `AE`, `GB`, `JP`, `SA`, `PL`, `SE`, `BE`, `EG`, `ZA`, `IE`. Default: `US`. |
| `star_rating` | No | Only return reviews with a specific star rating or positive / negative sentiment. Values: `ALL`, `5_STARS`, `4_STARS`, `3_STARS`, `2_STARS`, `1_STARS`, `POSITIVE`, `CRITICAL`. Default: `ALL`. |
| `page` | No | The page of seller feedback results to retrieve. Default: `1`. |
| `language` | No | The language of the results. In case not specified, results will be returned in the default domain language. |
| `fields` | No | A comma separated list of seller review fields to include in the response (field projection). By default all fields are returned. |

#### Seller Products

`GET /seller-products`

Get and paginate through the products sold by an Amazon Seller

| Parameter | Required | Description |
|---|---|---|
| `seller_id` | Yes | The Amazon Seller ID for which to get seller product listings |
| `country` | No | Sets the Amazon domain, marketplace country, language and currency. Values: `US`, `AU`, `BR`, `CA`, `CN`, `FR`, `DE`, `IN`, `IT`, `MX`, `NL`, `SG`, `ES`, `TR`, `AE`, `GB`, `JP`, `SA`, `PL`, `SE`, `BE`, `EG`, `ZA`, `IE`. Default: `US`. |
| `delivery_country` | No | 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. |
| `delivery_zipcode` | No | Postal / ZIP code within the `country` marketplace, in its usual format, used as the delivery address so delivery dates, costs, availability and offers reflect it. An invalid zip code returns a 400 error. |
| `page` | No | The page of seller products results to retrieve Seller products result page to retrieve. Default: `1`. |
| `sort_by` | No | Return the results in a specific sort order. Values: `RELEVANCE`, `LOWEST_PRICE`, `HIGHEST_PRICE`, `REVIEWS`, `NEWEST`, `BEST_SELLERS`. Default: `RELEVANCE`. |
| `language` | No | The language of the results. In case not specified, results will be returned in the default domain language. |
| `fields` | No | A comma separated list of seller product fields to include in the response (field projection). By default all fields are returned. |

#### Best Sellers

`GET /best-sellers`

Get Amazon Best Sellers, including prices, ratings, rank and more data points available on Amazon Best Sellers listings. Supports all Amazon Best Seller list types using the type parameter: Best Sellers, New Releases, Movers & Shakers, Most Wished For, Gift Ideas.

| Parameter | Required | Description |
|---|---|---|
| `category` | Yes | 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. |
| `type` | No | Type of Best Seller list to return. Values: `BEST_SELLERS`, `GIFT_IDEAS`, `MOST_WISHED_FOR`, `MOVERS_AND_SHAKERS`, `NEW_RELEASES`. Default: `BEST_SELLERS`. |
| `page` | No | Page to return. Default: `1`. |
| `country` | No | Sets the Amazon domain, marketplace country, language and currency. Values: `US`, `AU`, `BR`, `CA`, `CN`, `FR`, `DE`, `IN`, `IT`, `MX`, `NL`, `SG`, `ES`, `TR`, `AE`, `GB`, `JP`, `SA`, `PL`, `SE`, `BE`, `EG`, `ZA`, `IE`. Default: `US`. |
| `delivery_country` | No | 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. |
| `delivery_zipcode` | No | Postal / ZIP code within the `country` marketplace, in its usual format, used as the delivery address so delivery dates, costs, availability and offers reflect it. An invalid zip code returns a 400 error. |
| `language` | No | The language of the results. In case not specified, results will be returned in the default domain language. |
| `fields` | No | A comma separated list of product fields to include in the response (field projection). By default all fields are returned. |

#### Deals

`GET /deals-v2`

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.

| Parameter | Required | Description |
|---|---|---|
| `country` | No | Sets the Amazon domain, marketplace country, language and currency. Values: `US`, `AU`, `BR`, `CA`, `CN`, `FR`, `DE`, `IN`, `IT`, `MX`, `NL`, `SG`, `ES`, `TR`, `AE`, `GB`, `JP`, `SA`, `PL`, `SE`, `BE`, `EG`, `ZA`, `IE`. Default: `US`. |
| `delivery_country` | No | 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. |
| `delivery_zipcode` | No | Postal / ZIP code within the `country` marketplace, in its usual format, used as the delivery address so delivery dates, costs, availability and offers reflect it. An invalid zip code returns a 400 error. |
| `offset` | No | 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` | No | Return deals with products in specific categories / departments. Multiple categories can be specified as a comma (,) separated list. |
| `min_product_star_rating` | No | Return deals with products star rating greater than a specific value Values: `ALL`, `1`, `2`, `3`, `4`. Default: `ALL`. |
| `price_range` | No | 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). Values: `ALL`, `1`, `2`, `3`, `4`, `5`. Default: `ALL`. |
| `discount_range` | No | 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). Values: `ALL`, `1`, `2`, `3`, `4`, `5`. Default: `ALL`. |
| `brands` | No | Return deals with products by specific brands. Multiple brands can be specified separated by comma (,). |
| `prime_early_access` | No | Only return prime early access deals. |
| `prime_exclusive` | No | Only return prime exclusive deals. |
| `lightning_deals` | No | Only return lightning deals |
| `language` | No | The language of the results. In case not specified, results will be returned in the default domain language. |
| `fields` | No | A comma separated list of deal fields to include in the response (field projection). By default all fields are returned. |

#### Deal Products

`GET /deal-products`

Get the products of a specific deal by Deal ID. Supports pagination using the page parameter. For now, only works for MULTI_ITEM deals with no canonical_deal_url (i.e. when deal_url is in the form of https://amazon_domain/deal/deal_id).

| Parameter | Required | Description |
|---|---|---|
| `deal_id` | Yes | Deal ID of the deal to fetch |
| `country` | No | Sets the Amazon domain, marketplace country, language and currency. Values: `US`, `AU`, `BR`, `CA`, `CN`, `FR`, `DE`, `IN`, `IT`, `MX`, `NL`, `SG`, `ES`, `TR`, `AE`, `GB`, `JP`, `SA`, `PL`, `SE`, `BE`, `EG`, `ZA`, `IE`. Default: `US`. |
| `delivery_country` | No | 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. |
| `delivery_zipcode` | No | Postal / ZIP code within the `country` marketplace, in its usual format, used as the delivery address so delivery dates, costs, availability and offers reflect it. An invalid zip code returns a 400 error. |
| `sort_by` | No | Return products in a specific order. Values: `FEATURED`, `LOWEST_PRICE`, `HIGHEST_PRICE`, `REVIEWS`, `NEWEST`, `BEST_SELLERS`. Default: `FEATURED`. |
| `page` | No | Results page to return. Default: `1`. |
| `language` | No | The language of the results. In case not specified, results will be returned in the default domain language. |
| `fields` | No | A comma separated list of deal product fields to include in the response (field projection). By default all fields are returned. |

#### Promo Code Details

`GET /promo-code-details`

Get the products offered by an Amazon promo code.

| Parameter | Required | Description |
|---|---|---|
| `promo_code` | Yes | 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` | No | Sets the Amazon domain, marketplace country, language and currency. Values: `US`, `AU`, `BR`, `CA`, `CN`, `FR`, `DE`, `IN`, `IT`, `MX`, `NL`, `SG`, `ES`, `TR`, `AE`, `GB`, `JP`, `SA`, `PL`, `SE`, `BE`, `EG`, `ZA`, `IE`. Default: `US`. |
| `delivery_country` | No | 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. |
| `delivery_zipcode` | No | Postal / ZIP code within the `country` marketplace, in its usual format, used as the delivery address so delivery dates, costs, availability and offers reflect it. An invalid zip code returns a 400 error. |
| `language` | No | The language of the results. In case not specified, results will be returned in the default domain language. |

#### Influencer Profile

`GET /influencer-profile`

Get Amazon Influencer profile details from the Amazon Influencer store page *(e.g. https://www.amazon.com/shop/tastemade)*.

| Parameter | Required | Description |
|---|---|---|
| `influencer_name` | Yes | The Amazon Influencer name for which to get profile details |
| `country` | No | Sets the Amazon domain, marketplace country, language and currency. Values: `US`, `AU`, `BR`, `CA`, `CN`, `FR`, `DE`, `IN`, `IT`, `MX`, `NL`, `SG`, `ES`, `TR`, `AE`, `GB`, `JP`, `SA`, `PL`, `SE`, `BE`, `EG`, `ZA`, `IE`. Default: `US`. |
| `fields` | No | A comma separated list of influencer profile fields to include in the response (field projection). By default all fields are returned. |
| `language` | No | The language of the results. In case not specified, results will be returned in the default domain language. |

#### Influencer Posts

`GET /influencer-posts`

Get all Amazon Influencer posts with pagination support.

| Parameter | Required | Description |
|---|---|---|
| `influencer_name` | Yes | The Amazon Influencer name for which to get posts |
| `country` | No | Sets the Amazon domain, marketplace country, language and currency. Values: `US`, `AU`, `BR`, `CA`, `CN`, `FR`, `DE`, `IN`, `IT`, `MX`, `NL`, `SG`, `ES`, `TR`, `AE`, `GB`, `JP`, `SA`, `PL`, `SE`, `BE`, `EG`, `ZA`, `IE`. Default: `US`. |
| `scope` | No | Return the results in a specific scope. Values: `ALL`, `IDEA_LISTS`, `PHOTOS`, `VIDEOS`. Default: `ALL`. |
| `query` | No | Find posts matching a search query. |
| `cursor` | No | 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` | No | Maximum number of posts to return. Default: `20`. |
| `language` | No | The language of the results. In case not specified, results will be returned in the default domain language. |
| `fields` | No | A comma separated list of influencer post fields to include in the response (field projection). By default all fields are returned. |

#### Influencer Post Products

`GET /influencer-post-products`

Get the list of products related to a "List" type post by Post ID.

| Parameter | Required | Description |
|---|---|---|
| `influencer_name` | Yes |  |
| `post_id` | Yes | 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` | No | Set the cursor value from the response of the previous call to get the next results page. |
| `language` | No | The language of the results. In case not specified, results will be returned in the default domain language. |

#### ASIN to GTIN

`GET /asin-to-gtin`

Convert an Amazon ASIN to GTIN / EAN / UPS identifiers. Valid values for type are EAN-13, UPC, or ISBN.

| Parameter | Required | Description |
|---|---|---|
| `asin` | Yes | Amazon product ASIN to convert. |
| `country` | No | Sets the Amazon domain, marketplace country, language and currency. Values: `US`, `AU`, `BR`, `CA`, `CN`, `FR`, `DE`, `IN`, `IT`, `MX`, `NL`, `SG`, `ES`, `TR`, `AE`, `GB`, `JP`, `SA`, `PL`, `SE`, `BE`, `EG`, `ZA`, `IE`. Default: `US`. |

#### GTIN to ASIN

`GET /gtin-to-asin`

Find Amazon products by GTIN, EAN, UPC, or ISBN. Returns a list of matching ASINs along with key product attributes (title, photo, URL, price, rating, rank).

| Parameter | Required | Description |
|---|---|---|
| `product_identifier` | Yes | Product identifier to look up on Amazon. Supports GTIN, EAN-13, UPC, or ISBN. |
| `country` | No | Sets the Amazon store to look the code up in. BE, EG, IE, SA, SE and ZA currently return no match for most codes. CN (Amazon China) is not supported. Values: `US`, `AU`, `BR`, `CA`, `FR`, `DE`, `IN`, `IT`, `MX`, `NL`, `SG`, `ES`, `TR`, `AE`, `GB`, `JP`, `SA`, `PL`, `SE`, `BE`, `EG`, `ZA`, `IE`. Default: `US`. |

#### Product Category List

`GET /product-category-list`

Get Amazon product categories per country / Amazon domain (for use with the "category_id" parameter of the Product Search only).

| Parameter | Required | Description |
|---|---|---|
| `country` | No | Sets the Amazon domain, marketplace country, language and currency. Values: `US`, `AU`, `BR`, `CA`, `CN`, `FR`, `DE`, `IN`, `IT`, `MX`, `NL`, `SG`, `ES`, `TR`, `AE`, `GB`, `JP`, `SA`, `PL`, `SE`, `BE`, `EG`, `ZA`, `IE`. Default: `US`. |

### Example input

```json
{
  "endpoint": "/search",
  "query": "Phone"
}
```

### Example output

One dataset item per result. A Product Search item looks like this (trimmed):

```json
{
  "asin": "B0CTW8TXGH",
  "product_title": "Tracfone | Motorola Moto g Play 2024 | Locked | 64GB | 5000mAh Battery | 50MP Quad Pixel Camera | 6.5-in. HD+ 90Hz Display | Sapphire Blue",
  "product_price": "$39.88",
  "product_original_price": null,
  "currency": "USD",
  "product_star_rating": "4.3",
  "product_num_ratings": 856,
  "product_url": "https://www.amazon.com/dp/B0CTW8TXGH",
  "product_photo": "https://m.media-amazon.com/images/I/71fflP-3W4L._AC_UY654_FMwebp_QL65_.jpg",
  "product_num_offers": 1,
  "product_minimum_offer_price": "$39.88",
  "is_best_seller": false,
  "is_amazon_choice": true,
  "is_prime": true,
  "climate_pledge_friendly": false,
  "sales_volume": "5K+ bought in past month",
  "delivery": "FREE delivery Mon, Jun 9 Or fastest delivery Tomorrow, Jun 5 Arrives before Father's Day",
  "has_variations": false,
  "product_badge": "Overall Pick"
}
```

The run's key-value store `OUTPUT` record holds the request parameters, the request id and any non-list fields of the response (for example a pagination cursor).

### Pricing

Pay per event: you pay per API request, at the same rates as our API plans. Most runs are one request; some parameters (such as fetching several pages at once) count as several, exactly as they do on the API.

| Apify plan | Price per 1,000 requests |
|---|---|
| Free | $5.00 |
| Starter (Bronze) | $2.50 |
| Scale (Silver) | $1.50 |
| Business (Gold) and above | $0.75 |

A request that fails is not charged.

### Using it from code

Run it through the [Apify API](https://docs.apify.com/api/v2) or a client library, with the input above as the JSON body:

```bash
curl -X POST "https://api.apify.com/v2/acts/openweb-ninja~real-time-amazon-data/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"endpoint":"/search","query":"Phone"}'
```

Need higher volume or a direct REST API? Real-Time Amazon Data API is also available as an API on [OpenWeb Ninja](https://www.openwebninja.com/api/real-time-amazon-data) and [RapidAPI](https://rapidapi.com/letscrape-6bRBa3QguO5/api/real-time-amazon-data).

### Support

For custom plans, high volumes or anything else:

- Email: support@openwebninja.com
- Discord: https://discord.gg/wxJxGsZgha

# Actor input Schema

## `endpoint` (type: `string`):

Which endpoint of the API to call. Each endpoint uses the parameters listed in its section below; parameters of other endpoints are ignored.

## `query` (type: `string`):

Search query (supports both free-form text queries or a product asin).<br><br><em>Used by: Product Search, Product Reviews, Influencer Posts. Required for Product Search.</em>

## `page` (type: `integer`):

Results page to return.<br><br><em>Used by: Product Search, Products by Category, Product Offers, Seller Reviews, Seller Products, Best Sellers, Deal Products.</em>

## `country` (type: `string`):

Sets the Amazon domain, marketplace country, language and currency.<br><br><em>Used by: Product Search, Products by Category, Product Details, Product Offers, Product Reviews, Product Review Details, Top Product Reviews, Scrape By URL, Seller Profile, Seller Reviews, Seller Products, Best Sellers, Deals, Deal Products, Promo Code Details, Influencer Profile, Influencer Posts, ASIN to GTIN, GTIN to ASIN, Product Category List.</em>

## `delivery_country` (type: `string`):

Delivery destination country (ISO 3166-1 alpha-2 code, e.g. <code>NL</code>). 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.<br>  Only specific <code>country</code> / <code>delivery_country</code> combinations are supported. Currently supported: <code>country</code> = <code>DE</code> with <code>delivery_country</code> = <code>NL</code> or <code>DK</code>, and <code>country</code> = <code>FR</code>, <code>IT</code> or <code>ES</code> with <code>delivery_country</code> = <code>NL</code>.<br>  Other combinations return a 400 error. If you need another combination, contact us at support@openwebninja.com and we will look into adding it.<br><br><em>Used by: Product Search, Products by Category, Product Details, Product Offers, Scrape By URL, Seller Products, Best Sellers, Deals, Deal Products, Promo Code Details.</em>

## `delivery_zipcode` (type: `string`):

Postal / ZIP code within the <code>country</code> marketplace, in its usual format, used as the delivery address so delivery dates, costs, availability and offers reflect it. An invalid zip code returns a 400 error. Cannot be combined with a different <code>delivery_country</code>.<br><br><em>Used by: Product Search, Products by Category, Product Details, Product Offers, Scrape By URL, Seller Products, Best Sellers, Deals, Deal Products, Promo Code Details.</em>

## `sort_by` (type: `string`):

Return the results in a specific sort order.<br><br><em>Used by: Product Search, Products by Category, Product Reviews, Seller Products, Deal Products.</em>

## `category_id` (type: `string`):

Find products in a specific category / department (e.g. computers-intl-ship).<br>  Use the Product Category List endpoint to get a list of valid categories and their ids for the country specified in the request.<br>  For numeric Amazon category IDs, use the category parameter instead.<br><br><em>Used by: Product Search, Products by Category. Required for Products by Category.</em>

## `category` (type: `string`):

Filter by specific numeric Amazon category.<br>  The category ID can be obtained from the Amazon category results URL, for example:<br>  https://amazon.com/s?node=2858778013 - the Amazon Category ID is <code>2858778013</code>.<br>  Multiple category values can be separated by comma (e.g. categoryId1,categoryId2).<br><br><em>Used by: Product Search, Best Sellers. Required for Best Sellers.</em>

## `min_price` (type: `integer`):

Only return product offers with price greater than a certain value.<br>  Specified in the currency of the selected country.<br>  For example, in case <code>country=US</code>, a value of <code>105.34</code> means <code>$105.34</code>.<br><br><em>Used by: Product Search, Products by Category.</em>

## `max_price` (type: `integer`):

Only return product offers with price lower than a certain value.<br>  Specified in the currency of the selected country.    For example, in case <code>country=US</code>, a value of <code>105.34</code> means <code>$105.34</code>.<br><br><em>Used by: Product Search, Products by Category.</em>

## `product_condition` (type: `string`):

Return products in a specific condition.<br><br><em>Used by: Product Search, Products by Category, Product Offers.</em>

## `brand` (type: `string`):

Find products with a specific brand.<br>  Multiple brands can be specified as a comma (,) separated list.<br>  The brand values can be seen from Amazon's search left filters panel, as seen here.<br><br><em>Used by: Product Search, Products by Category.</em>

## `seller_id` (type: `string`):

Find products sold by a specific seller (merchant). Multiple sellers can be specified as a comma (,) separated list.<br><br><em>Used by: Product Search, Seller Profile, Seller Reviews, Seller Products. Required for Seller Profile, Seller Reviews, Seller Products.</em>

## `is_prime` (type: `boolean`):

Only return prime products.<br><br><em>Used by: Product Search, Products by Category.</em>

## `deals_and_discounts` (type: `string`):

Return deals and discounts in a specific condition.<br><br><em>Used by: Product Search, Products by Category.</em>

## `four_stars_and_up` (type: `boolean`):

Return product listings with ratings of 4 stars & up.<br><br><em>Used by: Product Search, Products by Category.</em>

## `language` (type: `string`):

The language of the results. In case not specified, results will be returned in the default domain language.<br>   <strong>Supported languages per country:</strong><br>  <code>US</code>: en_US, es_US<br>  <code>AU</code>: en_AU<br>  <code>BR</code>: pt_BR<br>  <code>CA</code>: en_CA, fr_CA<br>  <code>FR</code>: fr_FR, en_GB<br>  <code>DE</code>: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK<br>  <code>IN</code>: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN<br>  <code>IT</code>: it_IT, en_GB<br>  <code>MX</code>: es_MX<br>  <code>NL</code>: nl_NL, en_GB<br>  <code>SG</code>: en_SG<br>  <code>ES</code>: es_ES, pt_PT, en_GB<br>  <code>TR</code>: tr_TR<br>  <code>AE</code>: en_AE, ar_AE<br>  <code>GB</code>: en_GB<br>  <code>JP</code>: ja_JP, en_US, zh_CN<br>  <code>SA</code>: ar_AE, en_AE<br>  <code>PL</code>: pl_PL<br>  <code>SE</code>: sv_SE, en_GB<br>  <code>BE</code>: fr_BE, nl_BE, en_GB<br>  <code>EG</code>: ar_AE, en_AE<br>  <code>ZA</code>: en_ZA   <code>IE</code>: en_IE<br><br><em>Used by: Product Search, Products by Category, Product Details, Product Offers, Product Reviews, Product Review Details, Top Product Reviews, Scrape By URL, Seller Profile, Seller Reviews, Seller Products, Best Sellers, Deals, Deal Products, Promo Code Details, Influencer Profile, Influencer Posts, Influencer Post Products.</em>

## `additional_filters` (type: `string`):

Any filters available on the Amazon page but not part of this endpoint's parameters.<br>  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.<br>    Multiple filters are supported and can be separated by comma (,).<br>    For example, when searching for science books with the Paperback book format filter selected, the Amazon URL is:<br>    https://www.amazon.com/s?k=science+books\&rh=p_n_feature_browse-bin%3A2656022011<br>    and the rh parameter value is:<br>    <code>p_n_feature_browse-bin%3A2656022011</code><br>    To filter for Paperback books, set the value of additional_parameters=p_n_feature_browse-bin%3A2656022011.<br><br><em>Used by: Product Search, Products by Category.</em>

## `fields` (type: `string`):

A comma separated list of product fields to include in the response (field projection).<br>  By default all fields are returned.<br><br><em>Used by: Product Search, Products by Category, Product Details, Product Offers, Product Reviews, Product Review Details, Top Product Reviews, Seller Profile, Seller Reviews, Seller Products, Best Sellers, Deals, Deal Products, Influencer Profile, Influencer Posts.</em>

## `asin` (type: `string`):

Product ASIN for which to get details.<br>  Supports batching of up to 10 ASINs in a single request, separated by comma.<br><br>  <strong>Billing:</strong> each ASIN is billed as a separate request, so a batch of 10 ASINs counts as 10 requests against the plan quota.<br><br><em>Used by: Product Details, Product Offers, Product Reviews, Top Product Reviews, ASIN to GTIN. Required for Product Details, Product Offers, Product Reviews, Top Product Reviews, ASIN to GTIN.</em>

## `more_info_query` (type: `string`):

A query to search and get more info about the product as part of Product Information, Customer Q\&As, and Customer Reviews.<br><br><em>Used by: Product Details.</em>

## `include_offers` (type: `boolean`):

Also return the product's offers from all sellers as <code>product_offers</code>, with the same offer fields as the Product Offers endpoint (first page of offers, all conditions). When set, each ASIN is billed as 2 requests.<br><br><em>Used by: Product Details.</em>

## `delivery` (type: `array`):

Find products with specific delivery option, specified as a comma delimited list of the following values:<br><br><em>Used by: Product Offers.</em>

## `limit` (type: `integer`):

Maximum number of offers to return.<br><br><em>Used by: Product Offers, Influencer Posts.</em>

## `cookie` (type: `string`):

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}<br><br><em>Used by: Product Reviews, Product Review Details, Scrape By URL. Required for Product Reviews, Product Review Details.</em>

## `cursor` (type: `string`):

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.<br><br><em>Used by: Product Reviews, Influencer Posts, Influencer Post Products.</em>

## `star_rating` (type: `string`):

Only return reviews with a specific star rating or positive / negative sentiment.<br><br><em>Used by: Product Reviews, Seller Reviews.</em>

## `verified_purchases_only` (type: `boolean`):

Only return reviews by reviewers who made a verified purchase.<br><br><em>Used by: Product Reviews.</em>

## `images_or_videos_only` (type: `boolean`):

Only return reviews containing images and / or videos.<br><br><em>Used by: Product Reviews.</em>

## `current_format_only` (type: `boolean`):

Only return reviews of the current format (product variant - e.g. Color).<br>  By default reviews are returned for all product variants<br><br><em>Used by: Product Reviews.</em>

## `review_id` (type: `string`):

The id of the product review for which to get details.<br><br><em>Used by: Product Review Details. Required for Product Review Details.</em>

## `url` (type: `string`):

The full Amazon URL to scrape. The API automatically detects the page type and returns the appropriate parsed data.<br><br>  <strong>Supported page types:</strong>   - Product details (e.g. <code>https://www.amazon.com/dp/B0D1XD1ZV3</code>)   - Product reviews (e.g. <code>https://www.amazon.com/product-reviews/B0D1XD1ZV3</code>)   - Deals (e.g. <code>https://www.amazon.com/deals</code>)   - Best sellers (e.g. <code>https://www.amazon.com/Best-Sellers/zgbs</code>)   - Seller profile (e.g. <code>https://www.amazon.com/sp?seller=A1D09S7Q0OD6TH</code>)   - Seller products   - Search results   - Amazon Haul<br><br><em>Used by: Scrape By URL. Required for Scrape By URL.</em>

## `return_html` (type: `string`):

Include the raw HTML of the scraped page in the response. <strong>Default:</strong> <code>false</code><br><br><em>Used by: Scrape By URL.</em>

## `type` (type: `string`):

Type of Best Seller list to return.<br><br><em>Used by: Best Sellers.</em>

## `offset` (type: `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.<br><br><em>Used by: Deals.</em>

## `categories` (type: `string`):

Return deals with products in specific categories / departments.<br>  Multiple categories can be specified as a comma (,) separated list.<br>  Numeric category id's can be found in the URL after selecting a specific category on https://www.amazon.com/deals.<br><br><em>Used by: Deals.</em>

## `min_product_star_rating` (type: `string`):

Return deals with products star rating greater than a specific value<br><br><em>Used by: Deals.</em>

## `price_range` (type: `string`):

Return deals with price within a specific price range.<br>  1 is lowest price range shown on Amazon (e.g. Under $25) while 5 is the highest price range (e.g. $200 & Above).<br><br><em>Used by: Deals.</em>

## `discount_range` (type: `string`):

Return deals with discount within a specific discount range.<br>  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).<br><br><em>Used by: Deals.</em>

## `brands` (type: `string`):

Return deals with products by specific brands.<br>  Multiple brands can be specified separated by comma (,).<br>  In addition, brand names can be found under the Brand filter on the filter/refinements panel on https://www.amazon.com/deals (when applicable).<br><br><em>Used by: Deals.</em>

## `prime_early_access` (type: `boolean`):

Only return prime early access deals.<br><br><em>Used by: Deals.</em>

## `prime_exclusive` (type: `boolean`):

Only return prime exclusive deals.<br><br><em>Used by: Deals.</em>

## `lightning_deals` (type: `boolean`):

Only return lightning deals<br><br><em>Used by: Deals.</em>

## `deal_id` (type: `string`):

Deal ID of the deal to fetch<br><br><em>Used by: Deal Products. Required for Deal Products.</em>

## `promo_code` (type: `string`):

Promo code for which to get products.<br>  The promo code can be extracted from the /promocode Amazon URL.<br>  For example the promo code for https://www.amazon.com/promocode/A31M10S4V50SOU is A31M10S4V50SOU.<br><br><em>Used by: Promo Code Details. Required for Promo Code Details.</em>

## `influencer_name` (type: `string`):

The Amazon Influencer name for which to get profile details<br><br><em>Used by: Influencer Profile, Influencer Posts, Influencer Post Products. Required for Influencer Profile, Influencer Posts, Influencer Post Products.</em>

## `scope` (type: `string`):

Return the results in a specific scope.<br><br><em>Used by: Influencer Posts.</em>

## `post_id` (type: `string`):

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).<br><br><em>Used by: Influencer Post Products. Required for Influencer Post Products.</em>

## `product_identifier` (type: `string`):

Product identifier to look up on Amazon. Supports GTIN, EAN-13, UPC, or ISBN.<br><br><em>Used by: GTIN to ASIN. Required for GTIN to ASIN.</em>

## Actor input object example

```json
{
  "endpoint": "/search",
  "query": "Phone",
  "page": 1,
  "country": "US",
  "delivery_country": "NL",
  "sort_by": "RELEVANCE",
  "category_id": "aps (All Departments)",
  "product_condition": "ALL",
  "is_prime": false,
  "deals_and_discounts": "NONE",
  "include_offers": false,
  "limit": 100,
  "cursor": "1",
  "star_rating": "ALL",
  "review_id": "RYRK6K6MMXB9C",
  "url": "https://www.amazon.com/dp/B0D1XD1ZV3",
  "return_html": "false",
  "type": "BEST_SELLERS",
  "min_product_star_rating": "ALL",
  "price_range": "ALL",
  "discount_range": "ALL",
  "deal_id": "B08B477BHS",
  "promo_code": "AZDIA7AYE39P2",
  "influencer_name": "tastemade",
  "scope": "ALL",
  "post_id": "amzn1.ideas.382NVFBNK3GGQ",
  "product_identifier": "9780132350884"
}
```

# Actor output Schema

## `results` (type: `string`):

One dataset item per result of the API call.

## `summary` (type: `string`):

Endpoint, parameters, request id, billed requests and any non-list response fields (such as a pagination cursor).

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "query": "Phone",
    "page": 1,
    "category_id": "aps (All Departments)",
    "limit": 100,
    "cursor": "1"
};

// Run the Actor and wait for it to finish
const run = await client.actor("openweb-ninja/real-time-amazon-data").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "query": "Phone",
    "page": 1,
    "category_id": "aps (All Departments)",
    "limit": 100,
    "cursor": "1",
}

# Run the Actor and wait for it to finish
run = client.actor("openweb-ninja/real-time-amazon-data").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "query": "Phone",
  "page": 1,
  "category_id": "aps (All Departments)",
  "limit": 100,
  "cursor": "1"
}' |
apify call openweb-ninja/real-time-amazon-data --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,openweb-ninja/real-time-amazon-data"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/TeQGDeb0QVgiiXTzw/builds/wNSOgb7cTNHhFpNuH/openapi.json