amazon/
product-detail

Use the Amazon Product Details API to collect public Amazon product details from known URLs, returning titles, descriptions, sellers, prices, ratings, review and sold counts, and media as normalized records.

Amazon Product Details API

Known product URLs
Multi-marketplace input
Normalized product 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 Details

Amazon products are public catalog items described by identifiers, titles, descriptions, seller context, prices, ratings, review counts, sold counts, and media. These fields support catalog enrichment, item comparison, source verification, and point-in-time product reporting.

Amazon Product Details API Features

  • Batch lookup from known product URLsSubmit one or more Amazon URLs in a single task and receive no more normalized product records than the number of valid URLs supplied.
  • Product identity, copy, and mediaEach record can include the product identifier and URL, title, description, collection timestamp, and available image or video references.
  • Seller, price, and visible product signalsNested seller and price objects sit alongside rating, review-count, and reported sold-count fields for consistent field-level processing.
  • Supported Amazon marketplace hostsThe URL validator accepts Amazon hosts for the United States, United Kingdom, Germany, France, Spain, Italy, Canada, Australia, India, and Japan, including their subdomains.

Amazon Product Details API Parameters

ParametersRequiredDescription
urlsRequiredRequired non-empty array of known Amazon product references. The 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.

How to Use the Amazon Product Details API

Submit known product URLs to the Amazon Product Details API, save the asynchronous task ID, and read normalized product records after the task succeeds.

  1. POST a urls array to /v1/amazon/product-detail using a Bearer token or API key.
  2. Save the returned task_id and poll GET /v1/tasks/{task_id} until status becomes succeeded or failed.
  3. Read data.results.items after success; when has_more is true, request the next result page with next_cursor without submitting another product task.
curl -X POST "https://api.socq.ai/v1/amazon/product-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.amazon.com/dp/B0CHHSFMRL"]}'

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

Amazon Product Details API Use Cases

  • Known-item catalog enrichment: Enrich an existing set of Amazon URLs with product titles, descriptions, seller context, prices, media, ratings, and counts from the Amazon Product Details API.
  • Point-in-time product comparison: Compare normalized price, currency, rating, review count, sold count, and seller fields across selected product records collected at the same time.
  • Product source verification: Use identifiers, canonical URLs, titles, descriptions, media references, and collection timestamps to review stored catalog references against public product pages.

Amazon Product Details API Pro Tips

  • Use product references whose parsed hostname belongs to a supported Amazon marketplace; a valid host alone does not guarantee that the target resolves to a public product record.
  • Do not send results_limit because the Amazon Product Details API fixes its provider result cap to the number of submitted URLs.
  • Treat seller, price, rating, review-count, sold-count, media, URL, and publication-time fields as nullable, and preserve a succeeded task with zero items instead of creating placeholder data.
  • Use next_cursor only when paging through stored task results; continue GET requests for the same task rather than repeating the paid POST.

Beyond the Amazon Product Details 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 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 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 Details API — FAQ

Amazon Product Details API is a programmatic interface for collecting public product details from known Amazon references. It returns normalized identifiers, titles, descriptions, seller and price objects, ratings, review and sold counts, media, and collection metadata.

Submit a non-empty urls array containing Amazon product URLs. The runtime accepts Amazon hosts for the US, UK, Germany, France, Spain, Italy, Canada, Australia, India, and Japan, including subdomains.

Yes. Add multiple known URLs to the urls array. The provider result cap equals the number of submitted URLs, and invalid, unavailable, or error rows can leave the successful result count lower.

The stable product schema includes identity and source fields, title, description, nested seller and price objects, rating, review count, reported sold count, media, and timestamps. Optional source values remain null when unavailable.

Pagination applies when reading stored results after the task succeeds, not when submitting product URLs. Follow next_cursor with GET /v1/tasks/{task_id} only while has_more is true.

The Amazon Product Details API reserves an estimate of 0.15 credits per submitted URL and settles at 0.15 credits per successfully returned product record. With a zero-credit base and base-only empty policy, a task with no returned records settles to zero.