Shop page
1 credit/v1/amazon/shopProduct cards from an Amazon shop or storefront URL. Names, prices, ratings, images.
url
Fetch Amazon search, product detail, reviews, sellers, and shop pages as structured JSON with one SocialCrawl API key. Shared commerce schema. Reads are priced in credits.
8 active endpoints. 1 and 5 credit tiers.
Eight live read endpoints for Amazon commerce. Shop pages, keyword search, ASIN product detail, reviews, seller offers, Best Sellers, deals, and seller profiles. Data API only. No buy, cart, or seller account tools.
/v1/amazon/shopProduct cards from an Amazon shop or storefront URL. Names, prices, ratings, images.
url
/v1/amazon/product-searchKeyword search across an Amazon marketplace. Product list with ASINs to deepen. Optional country and depth.
query, country, depth
/v1/amazon/productFull product detail for one ASIN. Title, price, rating, images, attributes. Advanced tier (5 credits).
asin, country
/v1/amazon/reviewsCustomer reviews for an ASIN. Rating, text, author, date. Advanced tier (5 credits).
asin, country
/v1/amazon/sellersSeller and offer rows for a product ASIN. Price competition across the buy box surface.
asin, country
/v1/amazon/best-sellersRanked Best Seller listings for a category slug. Optional type for New Releases or Movers and Shakers.
category, country, type, page
/v1/amazon/dealsAmazon deals currently on the deals page. Deal price, list price, savings, and ASIN.
country
/v1/amazon/sellerOne Amazon seller by seller id. Name, store URL, rating, and ratings count.
seller_id, country
Returns the products featured on an Amazon shop or storefront page: product name, price, rating, and image for each item.
Use it when you have a storefront page URL and want what that seller puts on it, rather than searching the whole catalogue.
1 credit
url · Full URL of the Amazon shop or storefront page
$ curl https://www.socialcrawl.dev/v1/amazon/shop?url=https%3A%2F%2Fwww.amazon.com%2Fshop%2Fsydneydelrey \
-H "x-api-key: sc_YOUR_API_KEY"// Running this live needs your own API key. Hit "Try it" to see an example responseAmazon is a normal SocialCrawl commerce surface. You call GET /v1/amazon/… with an API key, spend credits on live misses, and get a single JSON envelope back.
Send your key in the x-api-key header. No Amazon OAuth app for public reads. The same key works across SocialCrawl platforms.
All Amazon routes are GET. Pass asin, query, url, country, depth as query strings. We validate formats before charging.
Shop, search, and sellers cost 1 credit. Product and reviews cost 5 credits. Cache hits cost 0. Empty or hard failures refund.
Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached. Lists also carry pagination when the route pages.
Most products search first, then deepen only the ASINs that matter for detail, reviews, and sellers.
GET /v1/amazon/product-search?query=…ProductList with ASINs, titles, prices
Resolve candidates before you spend advanced credits on detail.
GET /v1/amazon/product?asin=…Full Product for one ASIN
Search cards are not a full PDP.
GET /v1/amazon/reviews?asin=…ReviewList for the ASIN
VoC text lives on reviews, not product.
GET /v1/amazon/sellers?asin=…SellerList of offers for the ASIN
Price and seller competition is a separate read.
GET /v1/amazon/product-search
?query=wireless+earbuds
&country=US
&depth=20
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
GET /v1/amazon/product?asin=B0FQFB8FMG&country=US
GET /v1/amazon/reviews?asin=B0FQFB8FMG&country=US{
"success": true,
"data": {
"product": {
"id": "B0FQFB8FMG",
"title": "Example wireless earbuds",
"price": { "current": 29.99, "currency": "USD" },
"rating": 4.5,
"url": "https://www.amazon.com/dp/B0FQFB8FMG"
}
},
"credits_used": 5,
"credits_remaining": 9995,
"request_id": "req_…",
"cached": false
}Field names match other SocialCrawl commerce platforms. Parse once, reuse across Amazon, Walmart, and Target.
id (ASIN), title, price, rating, images, attributes, url, country context
items or shop cards with title, price, rating, ASIN or product url
items[] with author, content.text, rating, published_at
offer rows: seller, price, condition, fulfillment hints
Same request lifecycle as every other /v1 platform endpoint. Amazon is not a sidecar.
Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit (600/min) and concurrency (50 in flight per key).
Registry lookup finds amazon/product-search (or product, reviews, sellers). Required params and format checks run first. Invalid input returns 400 with no charge. Valid calls debit the tier cost atomically before upstream work.
A deterministic cache key is built from platform + resource + params. Hit: return immediately, credits_used = 0. Miss: product, reviews, search, and sellers run as live merchant reads; shop resolves from the storefront URL. Retries on 5xx/network with a circuit breaker if the source is unhealthy.
Upstream JSON is mapped to commerce archetypes (Product, ProductList, ReviewList, SellerList, App, PlaceList as applicable), validated against the canonical Zod schema, then wrapped in the success envelope and logged for billing audit.
Billing rules that matter in production
Amazon is public marketplace data. We normalize it into the SocialCrawl commerce schema so your code does not learn a second merchant SDK.
Public product search, PDP detail, reviews, seller offers, and influencer shop pages. Read-only. No purchase or Seller Central access.
Product, reviews, search, and sellers are read live from Amazon's public marketplace surface. Shop pages resolve from the storefront URL you pass. One SocialCrawl key covers all of them.
A unified JSON envelope with Product, ProductList, ReviewList, and SellerList archetypes shared across commerce platforms.
No cart, checkout, inventory, or advertising write APIs. No private Seller Central metrics.
The jobs this API is most often used for.
ASIN research, review mining, and offer monitoring
Callers search by keyword, resolve ASINs, then fan out to product, reviews, and sellers. ASIN product and reviews at a flat 5 credits, sellers and search at 1, one key across SocialCrawl.
Search and detail are typically a few seconds on live miss. Cold marketplace queries can run longer.
The jobs Amazon data is most often used for. Each one is a full recipe with the endpoint chain and pricing.
Common ways teams put this data to work, and the stack each one tends to run.
product-search by keyword, then product and sellers for shortlists of ASINs.
Pull reviews by ASIN for brand and competitor language. Advanced tier, cache friendly on repeats.
sellers plus product for offer and list-price checks on a fixed ASIN set.
Search and sellers are 1 credit. Product and reviews are 5. Cache hits are free.
curl "https://www.socialcrawl.dev/v1/amazon/product-search?query=wireless+earbuds&country=US&depth=20" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/amazon/product?asin=B0FQFB8FMG&country=US" \
-H "x-api-key: sc_your_api_key_here"Same key as the rest of the catalog
Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.
Same Amazon data, two very different paths. Auth, rate limits, schema, and cost, side by side.
| Feature | SocialCrawl | Amazon PA-API |
|---|---|---|
| Authentication | One x-api-key header; works the moment you sign up | Requires an Amazon Associates account with qualifying affiliate sales |
| Setup | One GET request; no SDK or request signing required | Signed requests via AWS-style credentials and the PA-API SDK |
| Rate limits / quotas | Flat credit pricing regardless of sales volume | Request quota scales with the affiliate revenue you generate |
| Response schema | Unified commerce schema shared with Google Shopping and Trustpilot | PA-API-specific resources model built around affiliate use cases |
| Data coverage | Shop pages, product search, detail, full review text, and seller profiles | Strong product catalog data, but no customer review text and no influencer shops |
| Pricing | Standard calls cost 1 credit, advanced 5; 100 free credits at signup | Free, but access lapses if your affiliate sales drop |
Authentication
Setup
Rate limits / quotas
Response schema
Data coverage
Pricing
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usAsk AI about SocialCrawl