amazon/
reviews

The Amazon Reviews API collects public Amazon product reviews from supported URLs, returning text, ratings, author details, product references, timestamps, and media as normalized records.

Amazon Reviews API

Multiple product URLs
Review text and ratings
Author and product context
Normalized review 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 Reviews

Amazon product reviews are public customer feedback records with written text, ratings, author details, publication times, product references, and attached media. These records support product feedback research, rating comparisons, review monitoring, and source-linked data enrichment.

Amazon Reviews API Features

  • Multi-product URL inputSubmit one or more supported Amazon product URLs in a single Amazon Reviews API task and apply one result cap across the normalized reviews that are stored.
  • Review content and authorsEach record can preserve public review text, numeric rating, author identity, publication time, and attached images or videos.
  • Product-linked recordsNormalized results keep product identifiers and product URLs alongside review identity and source links so records remain tied to the reviewed item.

Amazon Reviews API Parameters

ParametersRequiredDescription
urlsRequiredRequired list of non-empty Amazon product references. Each parsed hostname must belong to a supported marketplace or subdomain; any scheme with a hostname and protocol-relative references are accepted. Each item becomes one provider input row.
results_limitOptionalMaximum normalized reviews stored for the whole task; defaults to 100 and accepts integers from 1 through 2,000.

How to Use the Amazon Reviews API

Submit supported product URLs to the Amazon Reviews API, track the asynchronous task, and read normalized review records with cursor pagination.

  1. Prepare one or more supported Amazon product URLs and choose a results_limit from 1 through 2,000.
  2. POST the request to /v1/amazon/reviews and save the returned task_id.
  3. Poll GET /v1/tasks/{task_id} until the task succeeds or returns a failure.
  4. Read data.results.items and request the returned next_cursor while has_more remains true.
curl -X POST "https://api.socq.ai/v1/amazon/reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.amazon.com/dp/B0CHHSFMRL"],"results_limit":3}'

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

Amazon Reviews API Use Cases

  • Product feedback research: Use review text, ratings, authors, and publication times from the Amazon Reviews API to examine the public feedback returned for known products.
  • Cross-product rating comparison: Submit multiple product URLs and group the returned ratings by subject_id or subject_url to compare the collected review records.
  • Review evidence enrichment: Attach source links, product references, author details, timestamps, and review media to existing product datasets or monitoring records.

Amazon Reviews API Pro Tips

  • Use product references whose parsed hostname belongs to a supported Amazon marketplace; shortened links on unrelated hosts and unsupported regional hosts fail validation.
  • Set results_limit for the total number of reviews you want stored across all submitted URLs, then follow next_cursor until has_more is false to read every stored page.
  • Key records by review id when present and retain subject_id or subject_url when grouping reviews by product.
  • Treat missing text, author fields, ratings, timestamps, product references, and media as unknown rather than inventing replacement values.

Beyond the Amazon Reviews 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 Product Search API — Search a supported Amazon storefront by product phrase and return normalized product, seller, price, rating, review, sold-count, media, and source fields when available.
  • 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 Reviews API — FAQ

Amazon Reviews API is a programmatic interface for collecting public product reviews from supported Amazon product URLs. It returns normalized review text, ratings, author details, timestamps, product references, source links, and media.

Submit a non-empty urls array whose parsed hostnames are amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in, amazon.co.jp, or their subdomains. Any scheme with a hostname and protocol-relative references are accepted.

results_limit is the maximum number of normalized reviews stored for the whole task, not a guaranteed count for each URL. The task can finish with fewer records when fewer public reviews are returned or duplicate records are removed.

After the task succeeds, read data.results.items and pass next_cursor to the task endpoint while has_more is true. The task result endpoint accepts a page limit from 1 through 500.

The Amazon Reviews API charges 0.15 SocQ credits for each successfully stored review. The request is reserved from results_limit, then settled against the actual result count; an empty result has no result charge.