# Social Fetch API - Amazon endpoints
# Base URL: https://api.socialfetch.dev
# Auth: x-api-key header (sfk_...)
# Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json
# Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json

1 documented Amazon operation. Do not invent paths - only the routes below (and their linked markdown pages) are supported.

## GET /v1/amazon/shop
Get Amazon Shop page
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/amazon/shop/get.mdx
SDK: client.amazon.getShop({ url: "https://www.amazon.com/shop/sydneydelrey" })
Parameters:
- url (required, string) - Public Amazon Shop storefront URL.
- cursor (optional, string) - Pagination cursor returned by a previous response.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
Empty results: Empty `data.lists`, `data.trendingPicks`, or `data.curations` with `lookupStatus: found` means this storefront page has no collections (or this page of a paginated shop is empty). `data.lists` mixes idea lists (`kind: list`) and shoppable photos (`kind: photo`). The cursor pages `data.lists`; profile, trendingPicks, and curations are first-page fields. This is not a product PDP lookup.
Disambiguation: Pass an amazon.com/shop/... creator storefront URL. Extra path segments such as `/list/...` are resolved to the storefront. Product pages (`/dp/`) and brand stores (`/stores/`) are rejected with HTTP 400.
curl "https://api.socialfetch.dev/v1/amazon/shop?url=https://www.amazon.com/shop/sydneydelrey" \
  -H "x-api-key: YOUR_API_KEY"