> ## Documentation Index
> Fetch the complete documentation index at: https://docs.socq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Amazon Storefront

> Get an Amazon creator storefront: profile, idea lists, curated posts and trending picks.

# Amazon Storefront

Creators in the Amazon Influencer Program run a storefront at amazon.com/shop/name where they group products into idea lists and curated posts. Read one storefront to see who the creator is, which social accounts they link, how their lists are organized and how many products each holds, and which items the storefront currently pushes as trending picks, with prices. Useful for scouting affiliate partners or following what a creator recommends this season.

```json theme={"dark"}
{
  "url": "https://www.amazon.com/shop/sydneydelrey"
}
```

Provide one storefront URL in url, in the form amazon.com/shop/name (other Amazon marketplaces work the same way). Each request costs 0.5 credits and returns one row with the first page of the storefront's lists, curations and trending picks. A storefront that does not exist fails with a refund.

## Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use `fields` for MCP queries, `_result_fields` for typed tools, or `--result-fields` in the CLI. Declared fields remain present when their value is `null`.

| Field | Type | Nullable | Description |
| - | - | - | - |
| `id` | `string` | Yes | Storefront name from the URL, used as the identifier. |
| `platform` | `string` | No | Platform the result belongs to, such as `instagram` or `linkedin`. |
| `resource` | `string` | No | SocQ resource represented by the result, such as `videos` or `comments`. |
| `type` | `string` | No | Category of the result item, such as `video`, `post`, or `comment`. |
| `url` | `string` | Yes | URL of the Amazon storefront. |
| `published_at` | `string` | Yes | Time the source item was published, in ISO 8601 format when available. |
| `collected_at` | `string` | No | Time SocQ collected or processed this result, in ISO 8601 format. |
| `name` | `string` | Yes | Display name of the creator. |
| `text` | `string` | Yes | Storefront description written by the creator. |
| `avatar_url` | `string` | Yes | URL of the creator's profile photo. |
| `is_top_creator` | `boolean` | Yes | Whether Amazon marks the creator as a top creator. |
| `social_urls` | `array<string>` | Yes | Links to the creator's social profiles shown on the storefront. |
| `lists` | `array<object>` | Yes | Idea lists on the storefront, as shown on its first page. |
| `lists.title` | `string` | Yes | Title of the list. |
| `lists.url` | `string` | Yes | URL of the list. |
| `lists.image_url` | `string` | Yes | URL of the list's cover image. |
| `lists.items_count` | `integer` | Yes | Number of products in the list. |
| `curations` | `array<object>` | Yes | Curated posts on the storefront, each grouping several products. |
| `curations.title` | `string` | Yes | Title of the curated post. |
| `curations.url` | `string` | Yes | URL of the curated post. |
| `curations.image_url` | `string` | Yes | URL of the curated post's cover image. |
| `curations.posts_count` | `integer` | Yes | Number of products in the curated post. |
| `trending_picks` | `array<object>` | Yes | Products the storefront currently highlights as trending. |
| `trending_picks.url` | `string` | Yes | URL of the product on the storefront. |
| `trending_picks.image_url` | `string` | Yes | URL of the product image. |
| `trending_picks.price` | `number` | Yes | Current price of the product in the marketplace's currency. |
| `trending_picks.discount` | `string` | Yes | Discount shown for the product, when any. |

The following example shows the response format for a completed task. Actual data depends on your query.

## Completed Task Response

```json theme={"dark"}
{
  "code": 200,
  "data": {
    "task_id": "example-amazon-shop",
    "status": "succeeded",
    "public_id": "amazon/shop",
    "result_count": 1,
    "credits_amount": 0.5,
    "results": {
      "limit": 50,
      "next_cursor": null,
      "has_more": false,
      "schema_id": "storefront",
      "schema_version": "1.0",
      "items": [
        {
          "id": "sydneydelrey",
          "platform": "amazon",
          "resource": "shop",
          "type": "storefront",
          "url": "https://www.amazon.com/shop/sydneydelrey",
          "published_at": null,
          "collected_at": "2026-11-17T23:54:07.629296Z",
          "name": "sydney del rey",
          "text": "sharing all of my favorite Amazon finds ᥫ᭡ click the icons below to follow me on socials! all photo & video content is also shoppable x",
          "avatar_url": "https://m.media-amazon.com/images/I/71D+tmgGHHL._CR0%2C0%2C972%2C972_._US500_SCLZZZZZZZ_.jpg",
          "is_top_creator": true,
          "social_urls": [
            "https://vm.tiktok.com/ZTFrowSpg/",
            "https://www.youtube.com/channel/UCWvW1JOQ-nsAinO1jLFgrVA",
            "https://www.pinterest.com/sydneydelrey"
          ],
          "lists": [
            {
              "title": "Holiday home goods",
              "url": "https://www.amazon.com/shop/sydneydelrey/list/XYAIGEFWJGML?tag=sydneybertonc-20",
              "image_url": "https://m.media-amazon.com/images/G/01/Influencer/full_bleed_pin_2x.png",
              "items_count": 107
            },
            {
              "title": "thanksgiving fitspo",
              "url": "https://www.amazon.com/shop/sydneydelrey/list/35KWG9X334D4Q?tag=sydneybertonc-20",
              "image_url": "https://m.media-amazon.com/images/G/01/Influencer/full_bleed_pin_2x.png",
              "items_count": 199
            },
            {
              "title": "my amazon boot collection",
              "url": "https://www.amazon.com/shop/sydneydelrey/list/3C0MB7YWND2K7?tag=sydneybertonc-20",
              "image_url": "https://m.media-amazon.com/images/G/01/Influencer/full_bleed_pin_2x.png",
              "items_count": 60
            }
          ],
          "curations": [
            {
              "title": "SHOES ✨",
              "url": "https://www.amazon.com/shop/sydneydelrey/curation/bdca11e0-6920-4402-ac72-2f2016ed1e36",
              "image_url": "https://m.media-amazon.com/images/I/31WrBrxRKAL._US225_SCLZZZZZZZ_.jpg",
              "posts_count": 14
            },
            {
              "title": "f/w fit try ons",
              "url": "https://www.amazon.com/shop/sydneydelrey/curation/71fad634-5787-4ee1-bc3c-6e3ca23e5eae",
              "image_url": "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",
              "posts_count": 109
            },
            {
              "title": "fall by category 🍂",
              "url": "https://www.amazon.com/shop/sydneydelrey/curation/7e16f5d6-99a7-4277-b498-caffddd25cd5",
              "image_url": "https://m.media-amazon.com/images/I/41gq2G5kbDL._US225_SCLZZZZZZZ_.jpg",
              "posts_count": 12
            }
          ],
          "trending_picks": [
            {
              "url": "https://www.amazon.com/shop/sydneydelrey/getProductDetails/B0FCLQD6BN?showRelatedPost=true&tag_override=sydneybertonc-20",
              "image_url": "https://m.media-amazon.com/images/I/41pf3SeQpRL._AC_.jpg",
              "price": 24.99,
              "discount": null
            },
            {
              "url": "https://www.amazon.com/shop/sydneydelrey/getProductDetails/B0H7JQ63LX?showRelatedPost=true&tag_override=sydneybertonc-20",
              "image_url": "https://m.media-amazon.com/images/I/312BjBBJwiL._AC_.jpg",
              "price": 19.97,
              "discount": null
            },
            {
              "url": "https://www.amazon.com/shop/sydneydelrey/getProductDetails/B0FS2G449L?showRelatedPost=true&tag_override=sydneybertonc-20",
              "image_url": "https://m.media-amazon.com/images/I/41hQG+UyrFL._AC_.jpg",
              "price": 27.13,
              "discount": null
            }
          ]
        }
      ]
    }
  }
}
```


## OpenAPI

````yaml api-manual/agent-api/agent-api.json POST /v1/amazon/shop
openapi: 3.1.0
info:
  title: SocQ Agent API
  version: v1-87892a6484c2
  description: Asynchronous social data API generated from the SocQ Capability Registry.
servers:
  - url: https://api.socq.ai
security: []
paths:
  /v1/amazon/shop:
    post:
      tags:
        - amazon
      summary: Amazon Storefront API
      description: >-
        Collect the profile, idea lists, curations and trending picks of Amazon
        creator storefronts.
      operationId: socq_amazon_shop
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: https://json-schema.org/draft/2020-12/schema
              type: object
              additionalProperties: false
              properties:
                callback_url:
                  type: string
                  format: uri
                url:
                  type: string
                  minLength: 1
                  description: >-
                    Amazon storefront URL, such as
                    https://www.amazon.com/shop/sydneydelrey.
              required:
                - url
              description: >-
                Provide the storefront URL of an Amazon creator in url. The
                result is one row with the storefront profile, its idea lists,
                curations and trending picks.
      responses:
        '200':
          description: Task accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentSubmitResponse'
        '422':
          description: Input validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentValidationErrorResponse'
      security:
        - bearerAuth: []
        - apiKeyAuth: []
components:
  schemas:
    AgentSubmitResponse:
      type: object
      properties:
        code:
          type: integer
          const: 200
        data:
          type: object
          properties:
            task_id:
              type: string
            status:
              type: string
            created_time:
              type:
                - string
                - 'null'
          required:
            - task_id
            - status
    AgentValidationErrorResponse:
      type: object
      properties:
        code:
          type: integer
          const: 422
        error:
          type: object
          properties:
            message:
              type: string
            type:
              type: string
            details:
              type: object
          required:
            - message
            - type
      required:
        - code
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.