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

# Browse Category

> List products within an Amazon browse-node category.

## Query Parameters

<ParamField query="node" type="string" required>
  Amazon browse-node id to list products from. You can find browse-node ids in product `bestsellers_rank` links or category URLs (`node=...`).
</ParamField>

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

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

<ParamField query="page" type="integer" default={1}>
  Page number for paginated results. Range: `1` - `20`.
</ParamField>

<ParamField query="sort_by" type="string">
  Sort order for results.

  | Value               | Description                   |
  | ------------------- | ----------------------------- |
  | `relevance`         | Best match (default)          |
  | `price_low_to_high` | Cheapest first                |
  | `price_high_to_low` | Most expensive first          |
  | `avg_review`        | Highest customer rating first |
  | `newest`            | Most recently added           |
</ParamField>

## Response

<ResponseField name="node" type="string">The browse-node id that was listed.</ResponseField>
<ResponseField name="domain" type="string">Marketplace domain.</ResponseField>

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

  <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="is_best_seller" type="boolean">Best Seller badge present.</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}
{
  "node": "172282",
  "domain": "com",
  "results": [
    {
      "position": 1,
      "asin": "B0CHWRXH8B",
      "title": "Bose QuietComfort Ultra Wireless Earbuds",
      "link": "https://www.amazon.com/dp/B0CHWRXH8B",
      "image": "https://m.media-amazon.com/images/I/61abc123.jpg",
      "price": { "value": 249.0, "currency": "USD", "symbol": "$", "raw": "$249.00" },
      "rating": 4.4,
      "ratings_total": 12480,
      "is_prime": true,
      "is_best_seller": true,
      "availability": "In Stock"
    }
  ],
  "pagination": { "current_page": 1, "total_pages": 20, "total_results": 660 }
}
```

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


## OpenAPI

````yaml GET /v1/amazon/category
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/category:
    get:
      tags:
        - Amazon Listings
      summary: Browse Category
      description: List products within an Amazon browse-node category.
      operationId: browseAmazonCategory
      parameters:
        - name: node
          in: query
          required: true
          schema:
            type: string
          description: Amazon browse-node id to list products from.
        - 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
            maximum: 20
          description: Page number for paginated results.
        - name: sort_by
          in: query
          schema:
            type: string
            enum:
              - relevance
              - price_low_to_high
              - price_high_to_low
              - avg_review
              - newest
          description: Sort order for results.
      responses:
        '200':
          description: Category product listing
          content:
            application/json:
              schema:
                type: object
                properties:
                  node:
                    type: string
                  domain:
                    type: string
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/SearchResult'
                  pagination:
                    $ref: '#/components/schemas/Pagination'
              example:
                node: '172282'
                domain: com
                results:
                  - position: 1
                    asin: B0CHWRXH8B
                    title: Bose QuietComfort Ultra Wireless Earbuds
                    link: https://www.amazon.com/dp/B0CHWRXH8B
                    image: https://m.media-amazon.com/images/I/61abc123.jpg
                    price:
                      value: 249
                      currency: USD
                      symbol: $
                      raw: $249.00
                    list_price: null
                    unit_price: null
                    rating: 4.4
                    ratings_total: 12480
                    is_prime: true
                    is_sponsored: false
                    is_amazons_choice: false
                    is_best_seller: true
                    bought_past_month: null
                    coupon: null
                    availability: In Stock
                pagination:
                  current_page: 1
                  total_pages: 20
                  total_results: 660
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

````