EveryData platform API

Amazon API

Amazon product results, product pages, buyer reviews, bestseller lists, and seller records are the Amazon objects documented here; 5 actions including `search`, `profile`, `reviews` keep Amazon selectors and outputs separate.

On Amazon, `search` handles matching public results through `keyword`, while `profile` handles the selected public record through `url`; neither Amazon action receives undeclared filters.

Endpoint
POST /api/v1/social
Capabilities
5
Per 1,000
$1.389

Available capabilities

Compare the Amazon actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.

ActionRequiredOptionalDeliveryLimitPer 1,000Response fields
search

Search

Use Amazon search to discover Amazon public results. Product discovery returns listing candidates that can vary by marketplace and query. For Amazon search, supply domain, lang, and keyword; results include url, image_url, asin, currency, rating_scale, rank, price, category, in_stock, title, description, seller_name, platform, rating_count, is_amazon_choice, list_price, rating, and brand.

keyworddomain, langSync deliveryCatalog values: defaultLimit=10, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.$1.39 per 1,000 requestsasin · title · url · brand · price · list_price · currency · rating · rating_scale · rating_count · in_stock · category · image_url · description · is_amazon_choice · seller_name · platform · rank
profile

Product details

Use Amazon profile to read one Amazon public record. For Amazon profile, url selects the Amazon record. Product detail centers one item page, including visible offer and catalog metadata. Call Amazon profile with lang and url; Amazon profile exposes rating, brand, list_price, description, in_stock, asin, image_url, category, price, rank, platform, is_amazon_choice, rating_count, url, seller_name, currency, title, and rating_scale.

urllangSync delivery$1.39 per 1,000 requestsasin · title · url · brand · price · list_price · currency · rating · rating_scale · rating_count · in_stock · category · image_url · description · is_amazon_choice · seller_name · platform · rank
reviews

Reviews

Use reviews on Amazon for review records. Use Amazon reviews with url; Amazon then selects review records. Call Amazon reviews with domain and url; Amazon reviews exposes review_id, is_vine, variant, author_name, text, product_asin, country, url, helpful_count, posted_at, rating_scale, rating, is_verified_purchase, title, and platform.

urldomainSync delivery$1.39 per 1,000 requestsreview_id · title · text · rating · rating_scale · posted_at · helpful_count · is_verified_purchase · is_vine · variant · country · url · author_name · product_asin · platform
bestsellers

Bestsellers

The selected bestseller list belongs to the Amazon bestsellers contract. Use Amazon bestsellers with keyword for Amazon the selected bestseller list. For Amazon bestsellers, supply keyword and lang; results include name, rating, id, price, review_count, rating_scale, offer_count, category, image_url, rank, url, and platform.

keywordlangSync deliveryCatalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.$1.39 per 1,000 requestsid · url · name · rank · price · rating · rating_scale · review_count · offer_count · category · image_url · platform
sellers

Sellers

For sellers on Amazon, select sellers. Use Amazon sellers with keyword for Amazon sellers. For Amazon sellers, supply keyword and lang; results include address, review_count, business_name, product_price, url, product_asin, id, product_name, rating, product_brand, product_url, product_rating, rating_scale, phone, product_currency, name, and platform.

keywordlangSync deliveryCatalog values: defaultLimit=10, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.$1.39 per 1,000 requestsid · url · name · business_name · phone · address · rating · rating_scale · review_count · product_asin · product_name · product_url · product_price · product_currency · product_brand · product_rating · platform

What does each Amazon action accept?

Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.

Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.

What do the Amazon search parameters mean?

Use Amazon search to discover Amazon public results. Product discovery returns listing candidates that can vary by marketplace and query. For Amazon search, supply domain, lang, and keyword; results include url, image_url, asin, currency, rating_scale, rank, price, category, in_stock, title, description, seller_name, platform, rating_count, is_amazon_choice, list_price, rating, and brand.

keywordRequired
Specifies the primary search string according to the requested Amazon action. In search, pass the product search terms. In bestsellers, pass a full Amazon bestsellers category URL or a category short name used to build the path. In sellers, pass a product or seller page URL; raw search terms generate a product search page rather than looking up a seller ID directly.
domainOptional
Specifies the Amazon country domain without a scheme or path, such as amazon.com, amazon.co.uk, or amazon.co.jp. The search action uses this value to build search URLs, while reviews uses it to select the target review store. It defaults to amazon.com, but non-US review requests should explicitly supply the domain that matches the product URL.
langOptional
Specifies the page language for supported Amazon endpoints using valid codes such as en or ja. Use zhcn for Simplified Chinese and zhtw for Traditional Chinese instead of a generic zh code. Requests accept only the language codes listed for the action, and selecting a language alters the rendered content rather than changing the target country store.
Allowed values:arbncsdadeenesfrhehijaknkomlmrtanlplptsvtatetrzhcnzhtw

What do the Amazon profile parameters mean?

Use Amazon profile to read one Amazon public record. For Amazon profile, url selects the Amazon record. Product detail centers one item page, including visible offer and catalog metadata. Call Amazon profile with lang and url; Amazon profile exposes rating, brand, list_price, description, in_stock, asin, image_url, category, price, rank, platform, is_amazon_choice, rating_count, url, seller_name, currency, title, and rating_scale.

urlRequired
Specifies an Amazon product URL, such as https://www.amazon.com/dp/<ASIN>. The reviews action extracts a 10-character uppercase alphanumeric ASIN from /dp/, /gp/product/, or /product-reviews/ paths; store homepages are not supported. For this parameter, profile fetches the product details page rather than user profile data.
Amazon: ASIN Definition and Lookup MethodsAmazon defines an ASIN as a 10-character alphanumeric product identifier and indicates that it can be found following /dp/ in product detail links.Checked
langOptional
Specifies the page language for supported Amazon endpoints using valid codes such as en or ja. Use zhcn for Simplified Chinese and zhtw for Traditional Chinese instead of a generic zh code. Requests accept only the language codes listed for the action, and selecting a language alters the rendered content rather than changing the target country store.
Allowed values:arbncsdadeenesfrhehijaknkomlmrtanlplptsvtatetrzhcnzhtw

What do the Amazon reviews parameters mean?

Use reviews on Amazon for review records. Use Amazon reviews with url; Amazon then selects review records. Call Amazon reviews with domain and url; Amazon reviews exposes review_id, is_vine, variant, author_name, text, product_asin, country, url, helpful_count, posted_at, rating_scale, rating, is_verified_purchase, title, and platform.

urlRequired
Specifies an Amazon product URL, such as https://www.amazon.com/dp/<ASIN>. The reviews action extracts a 10-character uppercase alphanumeric ASIN from /dp/, /gp/product/, or /product-reviews/ paths; store homepages are not supported. For this parameter, profile fetches the product details page rather than user profile data.
Amazon: ASIN Definition and Lookup MethodsAmazon defines an ASIN as a 10-character alphanumeric product identifier and indicates that it can be found following /dp/ in product detail links.Checked
domainOptional
Specifies the Amazon country domain without a scheme or path, such as amazon.com, amazon.co.uk, or amazon.co.jp. The search action uses this value to build search URLs, while reviews uses it to select the target review store. It defaults to amazon.com, but non-US review requests should explicitly supply the domain that matches the product URL.

What do the Amazon bestsellers parameters mean?

The selected bestseller list belongs to the Amazon bestsellers contract. Use Amazon bestsellers with keyword for Amazon the selected bestseller list. For Amazon bestsellers, supply keyword and lang; results include name, rating, id, price, review_count, rating_scale, offer_count, category, image_url, rank, url, and platform.

keywordRequired
Specifies the primary search string according to the requested Amazon action. In search, pass the product search terms. In bestsellers, pass a full Amazon bestsellers category URL or a category short name used to build the path. In sellers, pass a product or seller page URL; raw search terms generate a product search page rather than looking up a seller ID directly.
langOptional
Specifies the page language for supported Amazon endpoints using valid codes such as en or ja. Use zhcn for Simplified Chinese and zhtw for Traditional Chinese instead of a generic zh code. Requests accept only the language codes listed for the action, and selecting a language alters the rendered content rather than changing the target country store.
Allowed values:arbncsdadeenesfrhehijaknkomlmrtanlplptsvtatetrzhcnzhtw

What do the Amazon sellers parameters mean?

For sellers on Amazon, select sellers. Use Amazon sellers with keyword for Amazon sellers. For Amazon sellers, supply keyword and lang; results include address, review_count, business_name, product_price, url, product_asin, id, product_name, rating, product_brand, product_url, product_rating, rating_scale, phone, product_currency, name, and platform.

keywordRequired
Specifies the primary search string according to the requested Amazon action. In search, pass the product search terms. In bestsellers, pass a full Amazon bestsellers category URL or a category short name used to build the path. In sellers, pass a product or seller page URL; raw search terms generate a product search page rather than looking up a seller ID directly.
langOptional
Specifies the page language for supported Amazon endpoints using valid codes such as en or ja. Use zhcn for Simplified Chinese and zhtw for Traditional Chinese instead of a generic zh code. Requests accept only the language codes listed for the action, and selecting a language alters the rendered content rather than changing the target country store.
Allowed values:arbncsdadeenesfrhehijaknkomlmrtanlplptsvtatetrzhcnzhtw

How to use the Amazon API

  1. 01Read the public catalog and choose a platform action.
  2. 02Send the platform, action, and required parameters to POST /api/v1/social.
  3. 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
  4. 04Store the structured response fields needed by your application.
amazon_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"amazon","action":"search","params":{"keyword":"<keyword>"}}'

Amazon API questions

What can I retrieve with the Amazon API?

Set platform to amazon. The current catalog lists search, product details, reviews, bestsellers, and sellers. These action names identify different Amazon objects or views; they are not interchangeable search modes.

Which input starts a Amazon `search` request?

Specifies the primary search string according to the requested Amazon action. In search, pass the product search terms. In bestsellers, pass a full Amazon bestsellers category URL or a category short name used to build the path. In sellers, pass a product or seller page URL; raw search terms generate a product search page rather than looking up a seller ID directly. Send it as keyword inside params.

Which fields can Amazon `search` return?

Its declared schema includes asin, title, brand, and price. A declared field can still be absent from an individual source record, and every other action has its own field list.

Does every Amazon action return immediately?

No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.