> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scraperize.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Amazon Shop page
> Fetches a creator's Amazon Shop (influencer storefront) page: the creator profile (name, avatar, bio, socials, Top Creator/earns-commission status), their curated collections, the "Trending picks" products (with price), and the content feed of shoppable posts (idea lists / photos / videos) — each with its product ASINs, images, and affiliate product links. Paginate the feed with the returned `paging.pageToken`.
**Cost: 1 credit** per successful request. Errors and cache hits (`cache_max_age`) are free.
Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button).
```text Prompt
I want to make an API call to /v1/amazon/shop. Here are the details:
Endpoint: GET https://api.scraperize.com/v1/amazon/shop
Description: Fetches a creator's Amazon Shop (influencer storefront) page: the creator profile (name, avatar, bio, socials, Top Creator/earns-commission status), their curated collections, the "Trending picks" products (with price), and the content feed of shoppable posts (idea lists / photos / videos) — each with its product ASINs, images, and affiliate product links. Paginate the feed with the returned `paging.pageToken`.
Required Headers:
- x-api-key: Your API key
Parameters:
- url (string) [required]: Amazon Shop URL, e.g. https://www.amazon.com/shop/.
- pageToken (string): The `paging.pageToken` from a previous call, to fetch the next batch of posts.
- cache_max_age (select): Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh.
Example Response:
{
"data": {
"shop": {
"handle": "sydneydelrey",
"name": "sydney del rey",
"url": "https://www.amazon.com/shop/sydneydelrey",
"avatarUrl": "https://m.media-amazon.com/images/I/71D+tmgGHHL._CR0%2C0%2C972%2C972_._US500_SCLZZZZZZZ_.jpg",
"bio": "sharing all of my favorite Amazon finds ᥫ᭡ click the icons below to follow me on socials! all photo & video content is also shoppable x",
"isTopCreator": true,
"earnsCommissions": true,
"affiliateTag": "onamzsydn05c4-20",
"storefrontId": "2GK5L3R8SDDP8",
"totalPosts": 1833,
"socialLinks": [
{
"platform": "tiktok",
"url": "https://vm.tiktok.com/ZTFrowSpg/"
}
],
"curations": [
{
"id": "amzn1.curation.7e16f5d6-99a7-4277-b498-caffddd25cd5",
"title": "fall by category 🍂",
"postCount": 12,
"coverImage": "https://m.media-amazon.com/images/I/71ANtYnrf2L._US225_SCLZZZZZZZ_.jpg",
"url": "https://www.amazon.com/shop/sydneydelrey/curation/7e16f5d6-99a7-4277-b498-caffddd25cd5"
}
],
"trending": [
{
"asin": "B0FY2MD64Y",
"image": "https://m.media-amazon.com/images/I/410oP54WC7L._AC_.jpg",
"price": "$39.99",
"badge": null,
"productUrl": "https://www.amazon.com/dp/B0FY2MD64Y?tag=onamzsydn05c4-20"
}
]
},
"posts": [
{
"id": "amzn1.ideas.3QCPC18WETJFQ",
"type": "List",
"title": "fall fitspo",
"url": "https://www.amazon.com/shop/sydneydelrey/list/3QCPC18WETJFQ",
"image": "https://m.media-amazon.com/images/I/71ANtYnrf2L._AC_._US550_SCLZZZZZZZ_.jpg",
"heartCount": 488,
"productCount": 133,
"products": [
{
"asin": "B0FJ21MMRY",
"image": "https://m.media-amazon.com/images/I/41gq2G5kbDL._AC_.jpg",
"productUrl": "https://www.amazon.com/dp/B0FJ21MMRY?tag=onamzsydn05c4-20"
}
]
}
],
"postCount": 20,
"paging": {
"pageToken": "amzn1.vse.video.080daeab78de406c9874b56bf5624e1e_0_2026-09-23T22:47:50.824Z",
"hasMore": true
},
"fetchedAt": "2026-10-05T14:43:41.343Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}
Please help me write code in my preferred programming language to make this API call and handle the response appropriately. Include error handling and best practices.
```
## OpenAPI
````yaml /api-reference/openapi.json get /v1/amazon/shop
openapi: 3.0.3
info:
title: Scraperize API
version: 1.0.0
description: >-
Extract public data from social media platforms as clean JSON. Endpoints are
split by platform and by what they return, e.g. `GET /v1/twitter/tweet`.
## Authentication
Send your API key in the `x-api-key` header (or `Authorization: Bearer
`). Create keys in your dashboard.
## Credits
Each successful live scrape costs **1 credit**. Credits are prepaid and
never expire.
## Caching
Every endpoint accepts an optional `cache_max_age`
(`1d`|`3d`|`7d`|`14d`|`30d`). A cache hit within that window is returned for
**0 credits**.
## Responses
Success returns `{ "data": …, "meta": { "requestId", … } }`. Errors return
`{ "error": { "code", "message", "requestId" } }` with a matching HTTP
status. `meta` on a scrape carries `creditsCharged`, `creditsRemaining`,
`cached`, and (on a hit) `cachedAt`.
## Rate limits
Requests are limited per team per minute; over the limit returns `429` with
a `Retry-After` header.
servers:
- url: https://api.scraperize.com
description: Production
security:
- ApiKeyAuth: []
tags:
- name: Twitter
description: Twitter / X scraping endpoints
- name: Facebook
description: Facebook scraping endpoints
- name: Linkme
description: Linkme (link.me) scraping endpoints
- name: Amazon
description: Amazon (creator shop / storefront) scraping endpoints
- name: Linkbio
description: Linkbio (lnk.bio) scraping endpoints
- name: Pillar
description: Pillar (pillar.io) scraping endpoints
- name: Komi
description: Komi (komi.io) scraping endpoints
- name: Linktree
description: Linktree (linktr.ee) scraping endpoints
- name: Kick
description: Kick (kick.com) scraping endpoints
- name: Snapchat
description: Snapchat (snapchat.com) scraping endpoints
- name: Telegram
description: Telegram (t.me) scraping endpoints
- name: LinkedIn
description: LinkedIn scraping endpoints
- name: Twitch
description: Twitch scraping endpoints
- name: TikTok
description: TikTok (tiktok.com) scraping endpoints
paths:
/v1/amazon/shop:
get:
tags:
- Amazon
summary: Amazon Shop page
description: >-
Fetches a creator's Amazon Shop (influencer storefront) page: the
creator profile (name, avatar, bio, socials, Top
Creator/earns-commission status), their curated collections, the
"Trending picks" products (with price), and the content feed of
shoppable posts (idea lists / photos / videos) — each with its product
ASINs, images, and affiliate product links. Paginate the feed with the
returned `paging.pageToken`.
parameters:
- name: url
in: query
required: true
description: Amazon Shop URL, e.g. https://www.amazon.com/shop/.
schema:
type: string
example: https://www.amazon.com/shop/sydneydelrey
- name: pageToken
in: query
required: false
description: >-
The `paging.pageToken` from a previous call, to fetch the next batch
of posts.
schema:
type: string
- name: cache_max_age
in: query
required: false
description: >-
Optional. Return a cached result if one this age or newer exists —
served for **0 credits** with `meta.cached=true` and
`meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and
refreshes the cache. Omit to always scrape fresh.
schema:
type: string
enum:
- 1d
- 3d
- 7d
- 14d
- 30d
example: 7d
responses:
'200':
description: The Amazon Shop.
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
shop:
type: object
nullable: true
posts:
type: array
items:
type: object
postCount:
type: integer
paging:
type: object
properties:
pageToken:
type: string
nullable: true
hasMore:
type: boolean
fetchedAt:
type: string
format: date-time
meta:
type: object
description: >-
requestId + credit/caching metadata (creditsCharged,
creditsRemaining, cached, cachedAt).
required:
- data
- meta
example:
data:
shop:
handle: sydneydelrey
name: sydney del rey
url: https://www.amazon.com/shop/sydneydelrey
avatarUrl: >-
https://m.media-amazon.com/images/I/71D+tmgGHHL._CR0%2C0%2C972%2C972_._US500_SCLZZZZZZZ_.jpg
bio: >-
sharing all of my favorite Amazon finds ᥫ᭡ click the icons
below to follow me on socials! all photo & video content
is also shoppable x
isTopCreator: true
earnsCommissions: true
affiliateTag: onamzsydn05c4-20
storefrontId: 2GK5L3R8SDDP8
totalPosts: 1833
socialLinks:
- platform: tiktok
url: https://vm.tiktok.com/ZTFrowSpg/
- platform: youtube
url: >-
https://www.youtube.com/channel/UCWvW1JOQ-nsAinO1jLFgrVA
- platform: pinterest
url: https://www.pinterest.com/sydneydelrey
curations:
- id: amzn1.curation.7e16f5d6-99a7-4277-b498-caffddd25cd5
title: fall by category 🍂
postCount: 12
coverImage: >-
https://m.media-amazon.com/images/I/71ANtYnrf2L._US225_SCLZZZZZZZ_.jpg
url: >-
https://www.amazon.com/shop/sydneydelrey/curation/7e16f5d6-99a7-4277-b498-caffddd25cd5
- id: amzn1.curation.71fad634-5787-4ee1-bc3c-6e3ca23e5eae
title: f/w fit try ons
postCount: 108
coverImage: >-
https://m.media-amazon.com/images/S/shoppable-media-external-prod-iad-us-east-1/8d48ee6a-0c49-4441-b385-a50fb9d86618/3254e-2233-46c9-89bd-434412530._SX225_SCLZZZZZZZ_.jpeg
url: >-
https://www.amazon.com/shop/sydneydelrey/curation/71fad634-5787-4ee1-bc3c-6e3ca23e5eae
- id: amzn1.curation.bdca11e0-6920-4402-ac72-2f2016ed1e36
title: SHOES ✨
postCount: 13
coverImage: >-
https://m.media-amazon.com/images/I/71mkjOveOML._US225_SCLZZZZZZZ_.jpg
url: >-
https://www.amazon.com/shop/sydneydelrey/curation/bdca11e0-6920-4402-ac72-2f2016ed1e36
trending:
- asin: B0FY2MD64Y
image: >-
https://m.media-amazon.com/images/I/410oP54WC7L._AC_.jpg
price: $39.99
badge: null
productUrl: >-
https://www.amazon.com/dp/B0FY2MD64Y?tag=onamzsydn05c4-20
- asin: B0FPVP6J5B
image: >-
https://m.media-amazon.com/images/I/41bMCPb3wZL._AC_.jpg
price: $19.99
badge: null
productUrl: >-
https://www.amazon.com/dp/B0FPVP6J5B?tag=onamzsydn05c4-20
- asin: B0GTYQ9L2W
image: >-
https://m.media-amazon.com/images/I/21x1esz4U8L._AC_.jpg
price: $12.99
badge: null
productUrl: >-
https://www.amazon.com/dp/B0GTYQ9L2W?tag=onamzsydn05c4-20
posts:
- id: amzn1.ideas.3QCPC18WETJFQ
type: List
title: fall fitspo
url: >-
https://www.amazon.com/shop/sydneydelrey/list/3QCPC18WETJFQ
image: >-
https://m.media-amazon.com/images/I/71ANtYnrf2L._AC_._US550_SCLZZZZZZZ_.jpg
heartCount: 488
productCount: 133
products:
- asin: B0FJ21MMRY
image: >-
https://m.media-amazon.com/images/I/41gq2G5kbDL._AC_.jpg
productUrl: >-
https://www.amazon.com/dp/B0FJ21MMRY?tag=onamzsydn05c4-20
- asin: B0G3V2CNXL
image: >-
https://m.media-amazon.com/images/I/31wGMbl8mlL._AC_.jpg
productUrl: >-
https://www.amazon.com/dp/B0G3V2CNXL?tag=onamzsydn05c4-20
- asin: B0F1K1KF8Q
image: >-
https://m.media-amazon.com/images/I/418Krr3QwqL._AC_.jpg
productUrl: >-
https://www.amazon.com/dp/B0F1K1KF8Q?tag=onamzsydn05c4-20
- id: amzn1.ideas.1OX9UQ28GC2HG
type: List
title: fall shoes
url: >-
https://www.amazon.com/shop/sydneydelrey/list/1OX9UQ28GC2HG
image: >-
https://m.media-amazon.com/images/I/71jEGpZdLSL._AC_._US550_SCLZZZZZZZ_.jpg
heartCount: 255
productCount: 209
products:
- asin: B0F8JKFJ45
image: >-
https://m.media-amazon.com/images/I/31EtNQ+p-BL._AC_.jpg
productUrl: >-
https://www.amazon.com/dp/B0F8JKFJ45?tag=onamzsydn05c4-20
- asin: B0GQLD77MD
image: >-
https://m.media-amazon.com/images/I/31zllgm37TL._AC_.jpg
productUrl: >-
https://www.amazon.com/dp/B0GQLD77MD?tag=onamzsydn05c4-20
- asin: B0G5LZ2F3N
image: >-
https://m.media-amazon.com/images/I/41dUyaRXYJL._AC_.jpg
productUrl: >-
https://www.amazon.com/dp/B0G5LZ2F3N?tag=onamzsydn05c4-20
- id: amzn1.ideas.3PDR5YVGLMWCO
type: List
title: fall fashion
url: >-
https://www.amazon.com/shop/sydneydelrey/list/3PDR5YVGLMWCO
image: >-
https://m.media-amazon.com/images/I/71xqPJHWhrL._AC_._US550_SCLZZZZZZZ_.jpg
heartCount: 248
productCount: 224
products:
- asin: B0HGD8T9NL
image: >-
https://m.media-amazon.com/images/I/41zc24Is3hL._AC_.jpg
productUrl: >-
https://www.amazon.com/dp/B0HGD8T9NL?tag=onamzsydn05c4-20
- asin: B0H8P63GNW
image: >-
https://m.media-amazon.com/images/I/317oXjWd3ML._AC_.jpg
productUrl: >-
https://www.amazon.com/dp/B0H8P63GNW?tag=onamzsydn05c4-20
- asin: B0HGKYBZ7V
image: >-
https://m.media-amazon.com/images/I/31BoEbqolNL._AC_.jpg
productUrl: >-
https://www.amazon.com/dp/B0HGKYBZ7V?tag=onamzsydn05c4-20
postCount: 20
paging:
pageToken: >-
amzn1.vse.video.080daeab78de406c9874b56bf5624e1e_0_2026-09-23T22:47:50.824Z
hasMore: true
fetchedAt: '2026-10-05T14:43:41.343Z'
meta:
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
creditsCharged: 1
creditsRemaining: 4999
cached: false
'400':
description: Invalid or expired pageToken.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: BAD_REQUEST
message: The request was invalid.
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
'401':
description: Missing, invalid, or revoked API key.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: UNAUTHORIZED
message: API key required — pass it in the `x-api-key` header.
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
'402':
description: Not enough credits for this request.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: INSUFFICIENT_CREDITS
message: >-
This request costs 1 credit, but your balance is 0. Top up
to continue.
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
'404':
description: Shop not found / unavailable.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: NOT_FOUND
message: >-
The requested content was not found (it may not exist, be
deleted, or be private).
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
'422':
description: Invalid query parameters (missing or malformed url).
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: VALIDATION_ERROR
message: Request validation failed
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
details:
- path: url
message: Required
'429':
description: Over the per-minute rate limit — honour `Retry-After`.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: RATE_LIMITED
message: >-
Rate limit exceeded — max 100 requests per 60s. Retry in
~30s.
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
'503':
description: >-
Temporarily unavailable — retry after `Retry-After`. `error.code`
tells you why: `UPSTREAM_BLOCKED` (the source blocked this request),
`EXTRACTION_FAILED` (the source returned unexpected data),
`PLATFORM_UNAVAILABLE` (the source is down), or
`SERVICE_UNAVAILABLE` (we are at capacity).
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: UPSTREAM_BLOCKED
message: >-
The source is temporarily unavailable. Please try again
shortly.
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
components:
schemas:
Error:
type: object
properties:
error:
type: object
properties:
code:
type: string
example: NOT_FOUND
message:
type: string
example: The requested content was not found.
requestId:
type: string
example: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
details:
type: array
items:
type: object
description: Present on validation errors.
required:
- code
- message
- requestId
required:
- error
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: >-
Your API key. Send it in the `x-api-key` header (or `Authorization:
Bearer `). Create and manage keys from your dashboard.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.