Amazon Seller Info
Amazon seller-profile pages can disclose a seller name, public description, rating, feedback total, website, and location context. SocQ collects the available public fields for known seller URLs in a stable seller schema, while private, absent, marketplace-specific, or unavailable values remain null rather than inferred.
Features
- Known seller URL collectionSubmit one or more public seller-profile URLs from ten supported Amazon marketplaces, including the US, UK, EU, Canada, Australia, India, and Japan.
- Stable seller identityReceive seller ID, public URL, seller or business name, description, associated website, and the collection timestamp in one fixed result shape.
- Public reputation signalsKeep source-reported rating and feedback_count values when Amazon exposes them, without calculating or filling missing measurements.
- Marketplace location contextStore available location name, city, region, country, latitude, and longitude fields while allowing every optional location value to remain null.
Parameters
| Parameters | Required | Description |
|---|---|---|
urls | Required | Required non-empty array of public Amazon seller references. The parsed hostname must belong to a supported marketplace or subdomain; any scheme with a hostname and protocol-relative references are accepted. Use seller-profile paths for this detail operation. |
How to Use
Submit public Amazon seller-profile URLs, follow the asynchronous task, and read normalized seller records from the paginated task result.
- Copy one or more public Amazon seller-profile URLs from a supported marketplace.
- POST the urls array to /v1/amazon/seller-info and save the returned task_id.
- Poll /v1/tasks/{task_id} until the task succeeds or fails.
- Read data.results.items and follow next_cursor only when has_more is true.
curl -X POST "https://api.socq.ai/v1/amazon/seller-info" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.amazon.com/sp?seller=A2L77EE7U53NWQ"]}'
# Poll GET /v1/tasks/{task_id}
# Read normalized sellers from data.results.itemsBest Use Cases
- Seller identity mapping: Resolve a prepared list of seller-profile URLs into consistent seller IDs, names, public URLs, websites, and marketplace context.
- Reputation snapshots: Record the public rating, feedback total, and collected_at time for repeatable point-in-time comparison without treating the values as live feeds.
- Marketplace supplier review: Build a review queue that keeps public seller description, website, location, and feedback signals tied to the source profile URL.
Pro Tips
- Submit canonical seller-profile links such as /sp?seller={seller_id}; product pages and search pages pass the host rule but are not seller detail inputs.
- Do not send results_limit. The backend creates one detail input per URL and caps stored results to the number of submitted non-empty URLs.
- One accepted URL can return zero or one seller record. Missing or unavailable pages can therefore make result_count smaller than the URL count.
- Treat rating and feedback_count as source-reported snapshots, and use collected_at when comparing repeated collections.
- Location fields and website are optional. Do not infer legal presence, ownership, or verification from a null or public profile value.
Related APIs
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 Reviews API — Collect public product reviews from supported Amazon URLs with text, ratings, author details, product references, timestamps, and media.