Amazon Seller Storefront API
Third-party seller storefronts (/sp?seller= / /s?me=) — ASIN + canonical /dp URLs, price, badges. Not influencer /shop/{handle}.
GET request to /v1/amazon-shop/page that responds with clean JSON and costs 1 credit. Pass cache=true for a free 24h cache hit; default is always fresh. Start with 100 free credits — no credit card.What is the Amazon Seller Storefront API?
Pass an Amazon seller storefront URL (/sp?seller=… or /s?me=…) or raw seller ID (e.g. A294P4X9EWVXLJ) and get that merchant's product listings as clean JSON. Each product includes an extracted ASIN and a canonical https://www.amazon.com/dp/{ASIN} URL (joinable to Amazon's catalog — not shop/{handle}/getProductDetails/… affiliate paths), plus title, image, price/currency/priceFormatted, rating/reviews, and isPrime/isBestSeller/isSponsored. Also seller{id,name,url}, scrapedAt, and cursor pagination (nextCursor/hasMore). Billing is 1 credit per ~16-product storefront page. This is not the influencer Amazon Shop surface (amazon.com/shop/{handle}) that returns avatar/socials/lists/curations — those creator vitrines are a different product and return HTTP 400 here.
What you get
- Bulk list of seller storefront with metadata
- Dates, URLs, and engagement fields when available
- Configurable result limit
- Ideal for monitoring and content pipelines
Platform limits
Honest ceilings from the upstream platform surface — not Captapi bugs. Unexpected truncation here is usually the platform, not us.
- Influencer Amazon Shops (amazon.com/shop/{handle}) are out of scope — HTTP 400. That surface has socials[], lists[], curations[], trendingPicks[] and is not a seller storefront.
- Not an SC amazon/shop equivalent: SC targets creator affiliate vitrines; this endpoint targets third-party seller storefronts with ASIN-first product identity.
Try it
Fill in the parameters below and copy a ready-to-run request, or open the live Playground to run it against your account (no API key paste).
Parameters
curl "https://api.captapi.com/v1/amazon-shop/page?url=https%3A%2F%2Fwww.amazon.com%2Fsp%3Fseller%3DA294P4X9EWVXLJ" \
-H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."Edit the parameters and the code updates instantly. Switch languages and hit copy.
Example response
{
"success": true,
"data": {
"platform": "amazon_shop",
"url": "https://www.amazon.com/sp?seller=A294P4X9EWVXLJ",
"marketplace": "US",
"seller": {
"id": "A294P4X9EWVXLJ",
"name": "AnkerDirect",
"url": "https://www.amazon.com/sp?seller=A294P4X9EWVXLJ"
},
"scrapedAt": "2026-08-02T16:59:58.250Z",
"totalReturned": 5,
"hasMore": true,
"nextCursor": "1:5",
"products": [
{
"asin": "B08NDYQSXZ",
"title": "Anker Charging Dock for Oculus Quest 2, Oculus Certified Charging Station Stand Set, Headset Display Holder and Controller Mount Station with 2 Rechargeable Batteries, USB-C Charger and Cable",
"url": "https://www.amazon.com/dp/B08NDYQSXZ",
"image": "https://m.media-amazon.com/images/I/61EK9jpDapL._AC_UY218_.jpg",
"price": 49.99,
"currency": "USD",
"priceFormatted": "$49.99",
"rating": 4.4,
"reviews": null,
"isPrime": false,
"isBestSeller": false,
"isSponsored": false
},
{
"asin": "B08HKPDZSD",
"title": "Anker Ergonomic Optical USB Wired Vertical Mouse 1000/1600 DPI, 5 Buttons CE100 (Renewed)",
"url": "https://www.amazon.com/dp/B08HKPDZSD",
"image": "https://m.media-amazon.com/images/I/61Zu2ANcJbL._AC_UY218_.jpg",
"price": 16.89,
"currency": "USD",
"priceFormatted": "$16.89",
"rating": 4.5,
"reviews": null,
"isPrime": false,
"isBestSeller": false,
"isSponsored": false
}
]
}
}Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Source. Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.
Response structure
A successful call returns success, cached, creditsUsed, and a data object with the following fields:
Top-level fields
platformPlatform identifier for this response (matches the endpoint's platform).urlCanonical product page https://www.amazon.com/dp/{ASIN} (not a shop/{handle}/getProductDetails/… affiliate path).marketplaceAmazon marketplace code echoed from the request (default US).scrapedAtWhen this response was collected (ISO 8601). Envelope-level freshness on listings that expose it (e.g. Facebook profile-posts) — not a per-row stamp on Spotify search.totalReturnedNumber of items returned in this response.hasMoreWhether more results are available beyond this page. When true, pass nextCursor to fetch the next page.nextCursorCursor to pass for the next page of results. May be null when the platform does not expose deep pagination (e.g. some Facebook Ad Library searches).
Seller
The seller object contains:
idStable platform ID for the item.nameName of the item or account. On profile endpoints: deprecated alias of displayName (one release).urlCanonical product page https://www.amazon.com/dp/{ASIN} (not a shop/{handle}/getProductDetails/… affiliate path).
Products
Each item in products contains:
asinAmazon Standard Identification Number — catalog identity for joins across sellers and marketplaces.titleTitle of the item.urlCanonical product page https://www.amazon.com/dp/{ASIN} (not a shop/{handle}/getProductDetails/… affiliate path).imageImage URL.pricePrice of the item.currencyCurrency code.priceFormattedFormatted price string.ratingAverage rating.reviewsNumber of reviews.isPrimeIs prime. Example: false.isBestSellerIs best seller. Example: false.isSponsoredIs sponsored. Example: false.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | Amazon seller storefront URL (/sp?seller=… or /s?me=…) or raw seller ID. Not influencer /shop/<handle> pages. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble. |
| marketplace | string | No | Amazon marketplace code. Default US. |
| limit | integer | No | Max products to include (default 20, max 200; 0 = seller metadata only). Billed per storefront page — 1 credit per ~16 products. |
| cursor | string | No | Pagination cursor from nextCursor (page or page:offset). Leave empty for the first page. |
| cache | boolean | No | Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. |
Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 1 credit. Pass cache=true for a free 24h cache hit; default is always fresh.
How it works
- 1. Sign up — get 100 free credits, no card required.
- 2. Create a key from your dashboard.
- 3. Send one request to
/v1/amazon-shop/pageand parse the JSON response.
Use cases
Seller catalog ingest
Pull a merchant's ASIN list with canonical /dp URLs for price monitoring and catalog joins.
Badge & Prime signals
Track isPrime / isBestSeller / isSponsored on storefront rows without HTML scraping.
Pagination
Walk nextCursor/hasMore across ~16-product Amazon storefront pages at 1 credit each.
Not influencer shops
For amazon.com/shop/{handle} creator vitrines (socials/lists/curations), use a different product — this endpoint rejects those URLs.
Frequently asked questions
What does the Amazon Seller Storefront API do?+
The Amazon Seller Storefront API lets you list items in bulk with metadata from a public Amazon Shop seller storefront using one GET request to /v1/amazon-shop/page. It returns clean JSON — no OAuth or infrastructure setup required.
How many credits does the Amazon Seller Storefront API cost?+
Each successful call costs 1 credit. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Failed or empty results are never charged.
Do I need a Amazon Shop API key or OAuth?+
No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle proxies, rate limits, retries, and authentication for you.
Is this the same as influencer amazon.com/shop/{handle} pages?+
No. This endpoint scrapes third-party seller storefronts (/sp?seller= or /s?me=). Influencer Amazon Shops (amazon.com/shop/{handle}) are a different Amazon surface — creator vitrines with socials[], lists[], and curations[] — and return HTTP 400 here. Do not treat seller-storefront and influencer-shop APIs as equivalents in competitive comparisons.
Why do you return ASIN and /dp/{ASIN} instead of shop getProductDetails links?+
ASIN is Amazon's catalog identity. Emitting asin plus a canonical https://www.amazon.com/dp/{ASIN} URL lets you join products across sellers, marketplaces, and your own catalog. Affiliate paths like /shop/{handle}/getProductDetails/{ASIN}?showRelatedPost=true bury the ASIN in the path and are not the product page.
Is the Amazon Seller Storefront API suitable for production use?+
Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Use it for analytics, monitoring, and content automation.
Ready to use the Amazon Seller Storefront API?
Sign up, grab your key, and make your first call in 60 seconds.