Amazon Public Data API
Search public Amazon products and collect normalized product details, Best Sellers, reviews, and seller-profile records from supported marketplaces.
Available Amazon APIs
Use Product Search, Product Detail, Best Sellers, Reviews, and Seller Info for the corresponding public Amazon workflow.
What Amazon data can you retrieve?
SocQ returns normalized product, review, and seller records from supported public Amazon inputs, preserving nullable fields when the source does not expose a usable value.
Product identity and content
Retrieve available product IDs, titles, descriptions, public URLs, platform and resource labels, and collection timestamps.
Seller and price context
Keep normalized seller objects and price values alongside each discovered product when those values are available.
Visible reputation signals
Use available ratings, review counts, and sold counts as point-in-time public observations without treating missing values as zero.
Product media
Receive normalized media objects that can support product catalogs, audit queues, and downstream visual processing.
SocQ vs direct page processing
SocQ provides authenticated task workflows and standard result schemas for supported public Amazon data. Direct page processing leaves request orchestration, parsing, storage, pagination, and schema maintenance to your application.
| Capability | SocQ | Direct page processing |
|---|---|---|
| Starting input | Search terms or supported public Amazon URLs | Page URLs and application-specific fetching logic |
| Execution model | Asynchronous task with status polling | Defined and operated by your application |
| Product shape | Normalized product records | Page-specific markup and custom parsing |
| Stored result access | Cursor-paginated items | Application-owned storage and pagination |
How the Amazon API works
Amazon endpoints use an asynchronous task followed by cursor-paginated result retrieval.
1. Submit an endpoint input
Send the search terms, product URLs, category URLs, or seller URLs required by the selected endpoint and save the task_id.
2. Track processing
Poll /v1/tasks/{task_id} until processing succeeds or the task reports a failure.
3. Retrieve products
Read data.results.items and follow next_cursor while has_more is true to retrieve all saved records.
Authenticate with a SocQ API key, submit a public category-list URL, and follow the asynchronous task to its product results.
curl -X POST "https://api.socq.ai/v1/amazon/best-sellers" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics"],"results_limit":3}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCommon Amazon API use cases
Category assortment research
Create bounded snapshots of products visible on selected Best Sellers pages for a defined category research set.
Product shortlist enrichment
Add titles, descriptions, seller context, prices, media, and public links to products discovered from chosen category pages.
Commerce signal comparison
Compare available prices, ratings, review counts, and sold counts across normalized products while retaining collection time.
Limits and public-data policy
Amazon results are point-in-time records from supported public pages. The API does not access customer accounts, private data, carts, orders, inventory systems, or seller-management functions.
- Supported hosts are 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 their subdomains.
- Use public Best Sellers or category-list pages. Host validation does not guarantee that an unrelated Amazon page contains a supported product list.
- results_limit defaults to 100, accepts 1 through 2,000, and caps the total unique saved results across all URLs in a task.
- The stable response does not include a Best Sellers rank field.
- Product IDs, content, seller, price, rating, counts, media, URLs, and publication times can be null when no usable public value is available.
Amazon API frequently asked questions
What is the Amazon API?
Amazon APIs search products and collect normalized product, review, and seller records from supported public Amazon inputs.
Which Amazon endpoints are available?
Product Search, Product Detail, Best Sellers, Reviews, and Seller Info are available through the shared asynchronous task workflow.
Can I collect more than one category URL?
Yes. Submit multiple URLs in one task, but remember that results_limit is one total cap shared across the task rather than a per-URL limit.
Does SocQ return the product rank?
No. Rank is not part of the stable product schema; use the available identity, seller, price, reputation, sold-count, media, source, and timestamp fields.
Can fields be missing from an Amazon product?
Yes. Standard product fields are nullable and should remain missing when the public record does not expose a usable value.
How is the Best Sellers endpoint priced?
Each successfully returned standard product costs 0.15 credits. Empty results have no result charge, and unused precharged credits are refunded when the task settles.
Combine data across platforms for more complete business insights
Bring public profiles, content, and engagement data from different platforms into one workflow to track brands, creators, and topics and run cross-platform monitoring and analysis more efficiently.
Douyin API
Retrieve public profiles and videos, search videos, collect one page of comments or creator videos, and inspect a known live room.
Instagram API
Look up or find public profiles and collect follower-list records, following relationships, authored posts, profile-tagged posts, hashtag results, Reels, transcripts, comments, account counts, engagement metrics and media metadata through one asynchronous workflow.
YouTube API
Collect supported public YouTube channel profiles, video details, channel videos, comments, Shorts, keyword and hashtag results, and available transcripts through one normalized asynchronous workflow.
X API
Collect public profiles, follower and following relationships, posts, replies, quotes, retweeters, search results, and current trends. Use consistent results for research and monitoring.
Facebook API
Collect public Facebook Page profiles, posts, group posts, comments, keyword-matched events, and available video transcripts with normalized identity, content, source, format, place, media, reaction, attendance, and engagement fields.
Google Ad Library API
Discover public advertisers, collect creatives for a company, or retrieve one known Transparency Center creative by URL for research and review.