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

# List Categories

> List common Amazon department/category aliases and bestseller nodes.

## Query Parameters

<ParamField query="domain" type="string" default="com">
  Amazon marketplace TLD or code. Category aliases are scoped per marketplace.

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

## Response

<ResponseField name="domain" type="string">Marketplace the aliases apply to.</ResponseField>

<ResponseField name="categories" type="array">
  Array of category aliases.

  <Expandable title="Category object">
    <ResponseField name="alias" type="string">Category alias usable in the [search](/api-reference/endpoint/amazon/search-products) `category` parameter (the `i=` value).</ResponseField>
    <ResponseField name="name" type="string">Human-readable department name.</ResponseField>
    <ResponseField name="bestsellers_node" type="string">Browse-node slug usable with [bestsellers](/api-reference/endpoint/amazon/bestsellers) and [new releases](/api-reference/endpoint/amazon/new-releases) (nullable).</ResponseField>
  </Expandable>
</ResponseField>

### Example Response

```json theme={null}
{
  "domain": "com",
  "categories": [
    { "alias": "electronics", "name": "Electronics", "bestsellers_node": "electronics" },
    { "alias": "stripbooks", "name": "Books", "bestsellers_node": "books" },
    { "alias": "fashion", "name": "Clothing, Shoes & Jewelry", "bestsellers_node": "fashion" },
    { "alias": "toys-and-games", "name": "Toys & Games", "bestsellers_node": "toys-and-games" }
  ]
}
```

<Note>
  The categories list is **free** (0 credits).
</Note>


## OpenAPI

````yaml GET /v1/amazon/categories
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/categories:
    get:
      tags:
        - Amazon Reference
      summary: List Categories
      description: List common Amazon department/category aliases and bestseller nodes.
      operationId: listAmazonCategories
      parameters:
        - name: domain
          in: query
          schema:
            type: string
            default: com
          description: >-
            Amazon marketplace TLD or code. Category aliases are scoped per
            marketplace.
      responses:
        '200':
          description: Category aliases
          content:
            application/json:
              schema:
                type: object
                properties:
                  domain:
                    type: string
                  categories:
                    type: array
                    items:
                      type: object
                      properties:
                        alias:
                          type: string
                          description: >-
                            Category alias usable in the search category
                            parameter (the i= value).
                        name:
                          type: string
                          description: Human-readable department name.
                        bestsellers_node:
                          type: string
                          nullable: true
                          description: >-
                            Browse-node slug usable with bestsellers /
                            new-releases.
              example:
                domain: com
                categories:
                  - alias: electronics
                    name: Electronics
                    bestsellers_node: electronics
                  - alias: stripbooks
                    name: Books
                    bestsellers_node: books
                  - alias: fashion
                    name: Clothing, Shoes & Jewelry
                    bestsellers_node: fashion
                  - alias: toys-and-games
                    name: Toys & Games
                    bestsellers_node: toys-and-games
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````