amazon/
product-search

The Amazon Product Search API searches a supported Amazon storefront by product phrase and returns normalized product, seller, price, rating, review, sold-count, and media fields.

Amazon Product Search API

Product search
Storefront scope
Normalized records
0.15 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Amazon Product Search

Amazon Product Search turns a product phrase and storefront URL into normalized public product records. Each item can include a source URL, title, description, seller, price, rating, review count, sold count, media, publication time, and collection time when those values are available.

Amazon Product Search API Features

  • Storefront-scoped queriesPair a non-empty product query with one supported Amazon domain so the requested storefront is explicit.
  • Controlled result volumeSet an integer results_limit from 1 through 2,000; the collector stops at the requested cap or when no more source records are available.
  • Normalized product identityReceive stable product fields for ID, type, source URL, title, description, publication time, and collection time.
  • Commerce contextUse available seller, price, rating, review-count, sold-count, and media fields without parsing storefront-specific result shapes.

Amazon Product Search API Parameters

ParametersRequiredDescription
queryRequiredRequired non-empty product keyword or phrase.
domainRequiredRequired Amazon storefront reference. Its parsed hostname must be amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in, amazon.co.jp, or a subdomain. Any scheme with a hostname and protocol-relative references are accepted.
results_limitOptionalRequested result cap from 1 through 2,000. Defaults to 100 when omitted.

How to Use the Amazon Product Search API

Choose the intended storefront and a concrete product phrase, then submit one asynchronous Amazon Product Search API request.

  1. Set a non-empty query, provide a supported Amazon domain URL, and choose results_limit from 1 through 2,000.
  2. POST the request to /v1/amazon/product-search and save the returned task_id.
  3. Poll /v1/tasks/{task_id} until the task reaches succeeded or failed.
  4. After success, read data.results.items and pass next_cursor while has_more is true.
curl -X POST "https://api.socq.ai/v1/amazon/product-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"wireless earbuds","domain":"https://www.amazon.com","results_limit":3}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Amazon Product Search API Use Cases

  • Storefront product discovery: Use the Amazon Product Search API to find public products matching a category, feature, brand, or purchase-intent phrase in one supported Amazon storefront.
  • Offer comparison: Compare available price amounts, currencies, formatted prices, and seller identity across returned products.
  • Reputation screening: Review available ratings, review counts, and sold counts while preserving missing signals as unavailable.
  • Catalog enrichment: Enrich product candidates with normalized titles, descriptions, source URLs, media, sellers, and collection timestamps.

Amazon Product Search API Pro Tips

  • Store the submitted query and domain with each task because the same phrase can produce different storefront results.
  • Choose results_limit for the volume you need: it determines the reserved result estimate, while final billing settles against returned records.
  • Follow next_cursor until has_more is false when a succeeded task contains more than one stored result page.
  • Treat missing seller, price, rating, review-count, sold-count, or media values as unavailable rather than zero or an empty identity.

Beyond the Amazon Product Search API, use these APIs when you need a different type of public Amazon data.

  • Amazon Best Sellers API — Collect products from public Amazon Best Sellers category URLs with normalized seller, price, reputation, sold-count, media, source, and timestamp fields.
  • Amazon Product Details API — Collect product details from known Amazon URLs with title, description, seller, price, rating, review-count, sold-count, and media fields.
  • Amazon Reviews API — Collect public product reviews from supported Amazon URLs with text, ratings, author details, product references, timestamps, and media.
  • Amazon Seller Info API — Collect public Amazon seller-profile identity, description, website, rating, feedback, location, source, and collection-time fields from known seller URLs.
  • Amazon Storefront API — Read an Amazon creator storefront from its shop URL with profile, linked social accounts, idea lists with item counts, curated posts, and trending picks with prices.

Explore other platforms

Combine Amazon data with public data from other supported social platforms.

Amazon Product Search API — FAQ

Amazon Product Search API searches one supported Amazon storefront using a product query and returns normalized public product records through an asynchronous task workflow.

The runtime checks the parsed hostname and accepts amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in, and amazon.co.jp, including subdomains. Any scheme with a hostname and protocol-relative references are accepted.

query and domain are required non-empty strings. results_limit is optional, defaults to 100, and must be an integer from 1 through 2,000.

A product can contain ID, platform, resource, type, source URL, publication and collection times, title, description, seller, price, rating, review count, sold count, and media. Nullable fields are present only when the source provides usable values.

results_limit is a maximum. Collection may finish earlier when the public source has no more matching records, so a successful task can contain fewer products or no products.

Poll /v1/tasks/{task_id}, read data.results.items after success, and request the next task-result page with next_cursor while has_more is true.

The Amazon Product Search API charges 0.15 SocQ credits for each successfully returned normalized product. The request reserves against results_limit, or 100 when omitted, then settles against the actual result count and refunds unused credit; an empty result has no result charge.