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

# Seller Products

> Products listed in a seller's storefront.

## Path Parameters

<ParamField path="seller_id" type="string" required>
  The Amazon seller ID whose storefront to list.
</ParamField>

## Query Parameters

<ParamField query="domain" type="string" default="com">
  Amazon marketplace TLD or code where the seller operates.

  Examples: `com`, `co.uk`, `de`
</ParamField>

<ParamField query="page" type="integer" default={1}>
  Page number for paginated storefront results. Starts at `1`.
</ParamField>

## Response

<ResponseField name="seller_id" type="string">The seller ID whose storefront was listed.</ResponseField>
<ResponseField name="domain" type="string">Marketplace domain.</ResponseField>

<ResponseField name="results" type="array">
  Array of products in the seller storefront.

  <Expandable title="SearchResult object">
    <ResponseField name="position" type="integer">Position on the page (1-based).</ResponseField>
    <ResponseField name="asin" type="string">Product ASIN.</ResponseField>
    <ResponseField name="title" type="string">Product title.</ResponseField>
    <ResponseField name="link" type="string">Full URL to the product page.</ResponseField>
    <ResponseField name="image" type="string">Primary product image URL.</ResponseField>
    <ResponseField name="price" type="object">Price object with `value`, `currency`, `symbol`, `raw`.</ResponseField>
    <ResponseField name="rating" type="number">Average star rating (nullable).</ResponseField>
    <ResponseField name="ratings_total" type="integer">Total number of ratings (nullable).</ResponseField>
    <ResponseField name="is_prime" type="boolean">Whether the item is Prime-eligible.</ResponseField>
    <ResponseField name="availability" type="string">Availability/stock message.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  Pagination metadata with `current_page`, `total_pages`, `total_results`.
</ResponseField>

### Example Response

```json theme={null}
{
  "seller_id": "A1B2C3D4E5F6G7",
  "domain": "com",
  "results": [
    {
      "position": 1,
      "asin": "B0CX23V2ZK",
      "title": "Anker Prime Power Bank (2026)",
      "link": "https://www.amazon.com/dp/B0CX23V2ZK",
      "image": "https://m.media-amazon.com/images/I/61new.jpg",
      "price": { "value": 129.99, "currency": "USD", "symbol": "$", "raw": "$129.99" },
      "rating": 4.6,
      "ratings_total": 842,
      "is_prime": true,
      "availability": "In Stock"
    }
  ],
  "pagination": { "current_page": 1, "total_pages": 4, "total_results": 96 }
}
```

<Note>
  Each seller products request costs **5 credits**. Failed requests are not charged.
</Note>


## OpenAPI

````yaml GET /v1/amazon/sellers/{seller_id}/products
openapi: 3.1.0
info:
  title: ScrapeBadger Amazon API
  version: 1.0.0
  description: >-
    Amazon marketplace scraping API for searching products, fetching product
    details, offers, reviews, listings, sellers, and reference data across 20
    marketplaces.
servers:
  - url: https://scrapebadger.com
    description: Production
security:
  - apiKeyAuth: []
paths:
  /v1/amazon/sellers/{seller_id}/products:
    get:
      tags:
        - Amazon Sellers
      summary: Seller Products
      description: Products listed in a seller's storefront.
      operationId: getAmazonSellerProducts
      parameters:
        - name: seller_id
          in: path
          required: true
          schema:
            type: string
          description: The Amazon seller ID whose storefront to list.
        - name: domain
          in: query
          schema:
            type: string
            default: com
          description: Amazon marketplace TLD or code (com, co.uk, de, ...).
        - name: page
          in: query
          schema:
            type: integer
            default: 1
            minimum: 1
          description: Page number for paginated storefront results.
      responses:
        '200':
          description: Seller storefront products
          content:
            application/json:
              schema:
                type: object
                properties:
                  seller_id:
                    type: string
                  domain:
                    type: string
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/SearchResult'
                  pagination:
                    $ref: '#/components/schemas/Pagination'
              example:
                seller_id: A1B2C3D4E5F6G7
                domain: com
                results:
                  - position: 1
                    asin: B0CX23V2ZK
                    title: Anker Prime Power Bank (2026)
                    link: https://www.amazon.com/dp/B0CX23V2ZK
                    image: https://m.media-amazon.com/images/I/61new.jpg
                    price:
                      value: 129.99
                      currency: USD
                      symbol: $
                      raw: $129.99
                    list_price: null
                    unit_price: null
                    rating: 4.6
                    ratings_total: 842
                    is_prime: true
                    is_sponsored: false
                    is_amazons_choice: false
                    is_best_seller: false
                    bought_past_month: null
                    coupon: null
                    availability: In Stock
                pagination:
                  current_page: 1
                  total_pages: 4
                  total_results: 96
components:
  schemas:
    SearchResult:
      type: object
      properties:
        position:
          type: integer
          description: Position of the result on the page (1-based).
        asin:
          type: string
          description: Amazon Standard Identification Number.
        title:
          type: string
          description: Product title.
        link:
          type: string
          description: Full URL to the product page.
        image:
          type: string
          description: Primary product image URL.
        price:
          $ref: '#/components/schemas/AmazonPrice'
        list_price:
          $ref: '#/components/schemas/AmazonPrice'
        unit_price:
          type: string
          nullable: true
          description: Unit price string (e.g. "$0.50 / count").
        rating:
          type: number
          nullable: true
          description: Average star rating (0-5).
        ratings_total:
          type: integer
          nullable: true
          description: Total number of ratings.
        is_prime:
          type: boolean
          description: Whether the item is Prime-eligible.
        is_sponsored:
          type: boolean
          description: Whether the result is a sponsored placement.
        is_amazons_choice:
          type: boolean
          description: Whether the item has the Amazon's Choice badge.
        is_best_seller:
          type: boolean
          description: Whether the item has the Best Seller badge.
        bought_past_month:
          type: string
          nullable: true
          description: Purchase-volume hint (e.g. "5K+ bought in past month").
        coupon:
          type: string
          nullable: true
          description: Coupon text, if any.
        availability:
          type: string
          nullable: true
          description: Availability/stock message.
    Pagination:
      type: object
      properties:
        current_page:
          type: integer
          description: Current page number.
        total_pages:
          type: integer
          description: Total number of pages available.
        total_results:
          type: integer
          description: Total number of results across all pages.
    AmazonPrice:
      type: object
      properties:
        value:
          type: number
          nullable: true
          description: Numeric price value.
        currency:
          type: string
          nullable: true
          description: ISO 4217 currency code.
        symbol:
          type: string
          nullable: true
          description: Currency symbol (e.g. $, £, €).
        raw:
          type: string
          nullable: true
          description: Price exactly as displayed on Amazon.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````