Amazon Shop scraper API
Look up a public creator Amazon Shop storefront by URL — identity, lists, trending picks, and curations in the shared Social Fetch envelope.
1 endpointWhy teams use Social Fetch for Amazon
Social Fetch exposes `GET /v1/amazon/shop` for **creator Amazon Shop pages** (`amazon.com/shop/{handle}`). Pass a public shop URL and get `data.lookupStatus`, a storefront `data.profile` (handle, name, description, avatar, isTopCreator, socials), plus `data.lists` (idea lists and shoppable photos), `data.trendingPicks` (ASIN and `/dp/` URL), and `data.curations` for the current page. Pagination uses `data.page` (`hasMore`, `nextCursor`); send the same `url` with `cursor` for the next page of the lists feed.
This is **not** Amazon's Product Advertising API, a generic catalog search, or a `/dp/` product-detail lookup. Regional hosts such as `amazon.co.uk` are out of scope. The same API key covers the rest of the marketplace catalog (23 platforms, 184 endpoints).
What Amazon data can you get?
- Creator Amazon Shop storefront lookup by public amazon.com/shop URL.
- Profile identity: handle, name, description, avatar, Top Creator flag, and linked socials.
- Idea lists and shoppable photos in data.lists (kind: list | photo), trending picks with ASIN + /dp/ URL, and shoppable curations.
- Cursor pagination of the lists feed — re-send url with data.page.nextCursor when hasMore is true. Profile, trending picks, and curations are first-page fields.
- Typed lookupStatus (found / not_found); empty collections on found still mean a resolved shop.
- Shared `{ data, meta }` envelope with TikTok Shop and the rest of the catalog.
- Rejects product PDPs (/dp/) and brand stores (/stores/) at validation time.
Amazon API endpoints
Routes from the live API catalog. Open an endpoint for parameters and examples — credit notes come from OpenAPI pricing extensions.
How to call the Amazon API
1. Create a key and call a real shop URL
Sign up at Social Fetch and copy an `sfk_…` key. New accounts get 100 free credits. Call `GET /v1/amazon/shop?url=https://www.amazon.com/shop/…` so you see `data.profile`, collection arrays, `data.page`, and `meta.creditsCharged` before you wire jobs.
2. Page the storefront
When `data.page.hasMore` is true, pass `data.page.nextCursor` as `cursor` and the same shop `url`. That cursor pages `data.lists` (idea lists and shoppable photos). Keep the first-page `data.profile`, `trendingPicks`, and `curations` — continuation pages typically omit them. Empty collections on `lookupStatus: found` means that page of the shop has no collections — not a failed product lookup.
3. Join rows to your commerce schema
Branch on `data.lookupStatus` before upserting. Store handle, list ids/URLs, pick ASINs, and prices beside your other marketplace rows. Filter `data.lists` by `kind` when you only want idea lists. Log `meta.requestId` on bad rows so support can trace the exact call.
How much does the Amazon API cost?
Amazon Shop is credit-metered per completed lookup (flat 1 credit). Always trust `meta.creditsCharged`. Credits never expire on pay-as-you-go packs. Signup includes 100 free credits.
Social Fetch vs the official Amazon API
Amazon's Product Advertising API is a partner catalog for ASIN/PDP product ads — it is not this route. Social Fetch reads public creator Shop storefronts by URL. You do not need Amazon PA-API credentials or OAuth. Use Amazon's own APIs when you need official product advertising, Buy with Prime, or seller tools.
Amazon API FAQ
Is there an Amazon Shop scraper API that works without Amazon PA-API?
Yes. Social Fetch `GET /v1/amazon/shop` reads a public creator Shop page by URL. You authenticate to Social Fetch with an API key (`x-api-key`). You do not register for Amazon Product Advertising API or act as the shop owner.
What Amazon data does Social Fetch cover?
Today: creator Amazon Shop storefronts (`GET /v1/amazon/shop`). The response includes lookupStatus, profile (handle, name, description, avatarUrl, profileUrl, isTopCreator, socials), lists (kind list or photo), trendingPicks (asin + /dp/ URL), curations, and page cursors. Exact fields live under `/docs/api` and on this hub's endpoint page.
How do I get an Amazon creator shop page via API?
Call `GET /v1/amazon/shop` with a required `url` pointing at `https://www.amazon.com/shop/{handle}` (www, m, and smile prefixes are accepted). Pass `cursor` from a previous `data.page.nextCursor` when `hasMore` is true.
Can I look up a product by ASIN or /dp/ URL?
No. This endpoint is a creator shop storefront lookup. Product detail pages (`/dp/`, `/gp/`) and brand stores (`/stores/`) return HTTP 400. Regional Amazon TLDs such as amazon.co.uk are not accepted.
What does lookupStatus found with empty lists mean?
The shop URL resolved. Empty `lists`, `trendingPicks`, or `curations` means that page of the storefront has no collections — not that the handle is missing. `not_found` is reserved for shops that did not resolve.
Amazon Product Advertising API vs Social Fetch — which should I use?
Use Amazon PA-API when you need official ASIN catalogs, advertising, or seller integrations they offer for your account. Use Social Fetch when you need a public creator Shop page as JSON without Amazon partner credentials — especially next to TikTok Shop and other storefronts on one key.
How much does the Amazon Shop API cost on Social Fetch?
You buy credit packs (or spend the 100 free signup credits). This route is a flat 1 credit per completed lookup; always check `meta.creditsCharged`. There is no required monthly subscription for pay-as-you-go packs.
Is scraping Amazon Shop data legal?
Social Fetch returns publicly visible storefront data. You are responsible for how you use it under Amazon's terms, applicable law, and your own compliance review. We do not give legal advice.
Start with Amazon data
Create an account, spend the 100 free credits on live Amazon routes, then buy a pack when the JSON fits your pipeline. Credits do not expire on pay-as-you-go packs.