amazon/
seller-info

The Amazon Seller Info API turns known public Amazon seller-profile URLs into normalized seller identity, description, website, rating, feedback, location, source, and collection-time fields.

Amazon Seller Info API

Seller profile details
Supported marketplaces
One record per URL
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 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.

Amazon Seller Info API 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.

Amazon Seller Info API Parameters

ParametersRequiredDescription
urlsRequiredRequired 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 the Amazon Seller Info API

Submit public Amazon seller-profile URLs to the Amazon Seller Info API, follow the asynchronous task, and read normalized seller records from the paginated task result.

  1. Copy one or more public Amazon seller-profile URLs from a supported marketplace.
  2. POST the urls array to /v1/amazon/seller-info and save the returned task_id.
  3. Poll /v1/tasks/{task_id} until the task succeeds or fails.
  4. 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.items

Amazon Seller Info API Use Cases

  • Seller identity mapping: Run a prepared list of seller-profile URLs through the Amazon Seller Info API to get 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.

Amazon Seller Info API 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.

Beyond the Amazon Seller Info 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 Reviews API — Collect public product reviews from supported Amazon URLs with text, ratings, author details, product references, timestamps, and media.
  • 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 Seller Info API — FAQ

Amazon Seller Info API is a URL-based interface for collecting publicly available Amazon seller-profile fields into a normalized seller schema. It does not access private Seller Central account data.

Runtime validation accepts Amazon hosts for the United States, United Kingdom, Germany, France, Spain, Italy, Canada, Australia, India, and Japan, including subdomains.

No. Each submitted non-empty URL becomes one detail input and can produce at most one stored seller record, but unavailable, invalid at the provider, or empty pages can return no record.

No. results_limit is not an accepted request field, and the provider receives one detail row per URL. The task-result endpoint can still paginate stored items with limit and next_cursor.

The Amazon Seller Info API charges 0.15 SocQ credits for each successfully returned seller record. The request reserves 0.15 credits per submitted URL, then settles against the actual result_count. A successful empty result has the zero-credit base charge and refunds the unused reservation.