Amazon Shop page API
Pass a public amazon.com/shop URL and get storefront identity, lists, trending picks, and curations in the shared Social Fetch envelope.
GET /v1/amazon/shop1 credit per successful request.
About this endpoint
`GET /v1/amazon/shop` takes a required public creator Shop `url` (`amazon.com/shop/...`; www, m, and smile prefixes are accepted). Extra path segments such as `/list/...` are accepted and resolved to the storefront. The response includes `data.lookupStatus` (`found` / `not_found`), `data.profile` when resolved (handle, name, description, avatarUrl, profileUrl, isTopCreator, socials as `{ platform, url }`), plus `data.lists`, `data.trendingPicks`, and `data.curations` for this page. `data.lists` is the storefront feed: idea lists (`kind: "list"`) mixed with shoppable photos (`kind: "photo"`, often with a null title). Trending picks include `asin` and a canonical `/dp/{ASIN}` product URL. Pagination is cursor-based: when `data.page.hasMore` is true, pass `data.page.nextCursor` as `cursor` and re-send the same `url`. Continuation pages typically return more `lists` only — profile details, trending picks, and curations are first-page fields.
This is a storefront lookup, not Amazon Product Advertising API and not a `/dp/` product page. Product and brand-store URLs return HTTP 400. Empty collection arrays on `found` mean that shop page has no lists/picks/curations. Bill from `meta.creditsCharged`.
Amazon Shop page API FAQ
How do I get an Amazon creator shop via API?
Call GET /v1/amazon/shop with your Social Fetch API key (x-api-key) and a public amazon.com/shop/... url. Read data.lookupStatus, then data.profile, data.lists, data.trendingPicks, data.curations, and data.page. See the API docs for parameters and examples.
How much does the Amazon Shop endpoint cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth. Each paginated page is a separate billed request.
What URL formats does the Amazon Shop API accept?
Creator storefront URLs on amazon.com with path /shop/{handle}... Optional www, m, and smile host prefixes. Product pages (/dp/) and brand stores (/stores/) are rejected. Regional TLDs such as amazon.co.uk are not accepted.
Does a completed lookup always mean the shop was found?
HTTP 200 means the request finished. Check data.lookupStatus: found means the storefront resolved (lists may still be empty); not_found means the shop URL did not resolve. Persist meta.requestId when you need to debug a miss.
How does pagination work?
When data.page.hasMore is true, pass data.page.nextCursor as cursor on the next request and send the same url. The cursor pages the lists feed (idea lists and shoppable photos). Profile fields, trendingPicks, and curations are returned on the first page and are typically empty on continuation pages — keep the first-page profile rather than overwriting it. The last page omits a usable next cursor.
Why do some lists have a null title?
data.lists mixes idea lists (kind: list) with shoppable photos (kind: photo). Photos usually have no title or itemCount. Filter by kind when you only want idea lists. Cover imageUrl is null when Amazon only supplied its generic influencer pin placeholder.
Is this the Amazon Product Advertising API?
No. This route reads a public creator Shop page. Use Amazon's own PA-API for official ASIN/catalog advertising. Social Fetch does not look up generic /dp/ product detail pages.
What do empty lists mean on a found shop?
The storefront identity resolved. Empty lists, trendingPicks, or curations mean that page of the shop has no collections — not that you passed a product URL (those fail validation with 400).
Do I need Amazon developer credentials?
No. You authenticate to Social Fetch with an API key. The route reads public shop pages; it does not act on behalf of a logged-in Amazon seller.