> ## 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.

# Get a creator's Amazon Shop

> 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`.



## 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
    <key>`). 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: Google
    description: Google Search scraping endpoints
paths:
  /v1/amazon/shop:
    get:
      tags:
        - Amazon
      summary: Get a creator's 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`.
      parameters:
        - name: url
          in: query
          required: true
          description: Amazon Shop URL, e.g. https://www.amazon.com/shop/<uniquename>.
          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: B2C2XJK73BDT
                    totalPosts: 1818
                    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/039230ec-2e77-4287-beca-ecba4b03ca46/8cdde-e153-4e81-b404-a1ebd6c65._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/71lc62SddGL._US225_SCLZZZZZZZ_.jpg
                        url: >-
                          https://www.amazon.com/shop/sydneydelrey/curation/bdca11e0-6920-4402-ac72-2f2016ed1e36
                    trending:
                      - asin: B0H4812HK1
                        image: >-
                          https://m.media-amazon.com/images/I/316Mzhek+9L._AC_.jpg
                        price: $10.79
                        badge: Deal
                        productUrl: >-
                          https://www.amazon.com/dp/B0H4812HK1?tag=onamzsydn05c4-20
                      - asin: B0FMNYBS75
                        image: >-
                          https://m.media-amazon.com/images/I/41Ews2+FfmL._AC_.jpg
                        price: $9.98
                        badge: Deal
                        productUrl: >-
                          https://www.amazon.com/dp/B0FMNYBS75?tag=onamzsydn05c4-20
                      - asin: B0GLZ4Q81C
                        image: >-
                          https://m.media-amazon.com/images/I/315PMrvsypL._AC_.jpg
                        price: $27.99
                        badge: Deal
                        productUrl: >-
                          https://www.amazon.com/dp/B0GLZ4Q81C?tag=onamzsydn05c4-20
                  posts:
                    - 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/71VdeGCZZ7L._AC_._US550_SCLZZZZZZZ_.jpg
                      heartCount: 176
                      productCount: 214
                      products:
                        - asin: B0GSH44KJR
                          image: >-
                            https://m.media-amazon.com/images/I/31h9cfmUywL._AC_.jpg
                          productUrl: >-
                            https://www.amazon.com/dp/B0GSH44KJR?tag=onamzsydn05c4-20
                        - asin: B0GSH5NZ53
                          image: >-
                            https://m.media-amazon.com/images/I/31swvQ3IM3L._AC_.jpg
                          productUrl: >-
                            https://www.amazon.com/dp/B0GSH5NZ53?tag=onamzsydn05c4-20
                        - asin: B0FYCTCVXY
                          image: >-
                            https://m.media-amazon.com/images/I/414o8e1zorL._AC_.jpg
                          productUrl: >-
                            https://www.amazon.com/dp/B0FYCTCVXY?tag=onamzsydn05c4-20
                    - id: >-
                        amzn1.shoppablemedia.v1.30c16cf6-7e24-42f5-a995-467affcbd606
                      type: Photo
                      title: null
                      url: >-
                        https://www.amazon.com/shop/sydneydelrey/photo/amzn1.shoppablemedia.v1.30c16cf6-7e24-42f5-a995-467affcbd606
                      image: >-
                        https://m.media-amazon.com/images/S/shoppable-media-external-prod-iad-us-east-1/5f0a9d3b-971c-4b1c-8cb9-709b3cdf4903/6d3b8-1331-4e4e-b7a5-0492c82c2._AC_._SX900_SCLZZZZZZZ_.jpeg
                      heartCount: 61
                      productCount: 4
                      products:
                        - asin: B0GHMRR4J2
                          image: >-
                            https://m.media-amazon.com/images/I/41RKgfsbxWL._AC_.jpg
                          productUrl: >-
                            https://www.amazon.com/dp/B0GHMRR4J2?tag=onamzsydn05c4-20
                        - asin: B0GK93RHN8
                          image: >-
                            https://m.media-amazon.com/images/I/31vlx5YKN5L._AC_.jpg
                          productUrl: >-
                            https://www.amazon.com/dp/B0GK93RHN8?tag=onamzsydn05c4-20
                        - asin: B07JBN9GW9
                          image: >-
                            https://m.media-amazon.com/images/I/31fEFRn0xDL._AC_.jpg
                          productUrl: >-
                            https://www.amazon.com/dp/B07JBN9GW9?tag=onamzsydn05c4-20
                    - id: amzn1.ideas.16P4Z5SKOB7EG
                      type: List
                      title: my amazon heel collection
                      url: >-
                        https://www.amazon.com/shop/sydneydelrey/list/16P4Z5SKOB7EG
                      image: >-
                        https://m.media-amazon.com/images/I/71lc62SddGL._AC_._US550_SCLZZZZZZZ_.jpg
                      heartCount: 222
                      productCount: 99
                      products:
                        - asin: B0GGL37Y5L
                          image: >-
                            https://m.media-amazon.com/images/I/41Hg-oqC4cL._AC_.jpg
                          productUrl: >-
                            https://www.amazon.com/dp/B0GGL37Y5L?tag=onamzsydn05c4-20
                        - asin: B0FSRQRG5B
                          image: >-
                            https://m.media-amazon.com/images/I/41Qg44tk8zL._AC_.jpg
                          productUrl: >-
                            https://www.amazon.com/dp/B0FSRQRG5B?tag=onamzsydn05c4-20
                        - asin: B0HDSN72FX
                          image: >-
                            https://m.media-amazon.com/images/I/41GgIyjF5FL._AC_.jpg
                          productUrl: >-
                            https://www.amazon.com/dp/B0HDSN72FX?tag=onamzsydn05c4-20
                  postCount: 20
                  paging:
                    pageToken: amzn1.ideas.1JVJAN9VKIAPO_0_2026-09-12T00:47:48.983Z
                    hasMore: true
                  fetchedAt: '2026-09-14T12:14:30.208Z'
                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
        '502':
          description: Upstream block.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  code: UPSTREAM_BLOCKED
                  message: >-
                    The source was 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 <key>`). Create and manage keys from your dashboard.

````