---
title: "Get StockX category/subcategory taxonomy"
method: GET
path: "/stockx/categories"
tags: ["StockX"]
---

# Get StockX category/subcategory taxonomy

`GET /stockx/categories`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/stockx/categories`
- Auth: API key in header `x-api-key`

Returns StockX's full category/subcategory reference: the 7 top-level categories accepted by GET /stockx/search's category parameter, each with its subcategories (e.g. Shoes -> Boots, Cleats, Clogs).

## Headers

- `x-api-key` string, required

## Response `200`

OK

- StockxCategoriesResponseDoc
  - `code` integer
  - `data` StockxCategoriesResponse
    - `categories` StockxCategory[]
      - `name` string
      - `slug` string
      - `subcategories` StockxSubcategory[]
        - `name` string
        - `slug` string
  - `msg` string

## Other responses

- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)