Endpoint Playground

Try the StockX category/subcategory taxonomy API

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

What a live request returned

14 Oct 2026: 7 categories; 3 fields had a value in every checked item.

Observed request: GET /stockx/categories
Fields with a value in every checked item: name, slug, subcategories

Sample value profiles: name: “Sneakers” and 6 other values; subcategories: median 11 entries.

Request: GET /stockx/categories
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.84 s
Monitored request: GET /stockx/categories

StockX category/subcategory taxonomy API documentation StockX platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/stockx/categories' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

No request parameters

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "categories": [
      {
        "name": "Shoes",
        "slug": "shoes",
        "subcategories": [
          {
            "name": "Boots",
            "slug": "boots"
          },
          {
            "name": "Cleats",
            "slug": "cleats"
          },
          {
            "name": "Sandals",
            "slug": "sandals"
          }
        ]
      },
      {
        "name": "Trading Cards",
        "slug": "trading-cards",
        "subcategories": [
          {
            "name": "Sealed Boxes",
            "slug": "sealed-boxes"
          },
          {
            "name": "Graded Singles",
            "slug": "graded-singles"
          },
          {
            "name": "Ungraded Singles",
            "slug": "ungraded-singles"
          }
        ]
      }
    ]
  }
}

More StockX endpoints

Get StockX brand catalog Get StockX product detail Get StockX upcoming release calendar Search/browse StockX products

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requeststockx.categoriesResponseDocStockX

GET /stockx/categories

Get StockX category/subcategory taxonomy

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

Response behavior

- `categories[].slug` matches `SearchOption.Category`'s allowed values exactly: `sneakers`, `shoes`, `apparel`, `accessories`, `collectibles`, `electronics`, `trading-cards`. - `subcategories` is not currently exposed as a `/stockx/search` filter parameter -- it is reference data for building category-scoped browsing, matching the `https://stockx.com/category/{category}/{subcategory}` URL pattern (e.g. `https://stockx.com/category/shoes/boots`). - Every category currently has at least one subcategory. Confirmed live 2026-08-04 (all values below, category → subcategory slugs): - `sneakers` → `lifestyle`, `luxury`, `performance` - `shoes` → `boots`, `cleats`, `clogs`, `flats`, `heels`, `loafers`, `oxfords`, `sandals`, `slides-and-sandals`, `slippers`, `spikes` - `apparel` → `bottoms`, `other-apparel`, `outerwear`, `tops`, `undergarments` - `accessories` → `bags`, `belts`, `eyewear`, `face-masks`, `headwear`, `home-and-lifestyle`, `jewelry`, `lanyards-and-keychains`, `other-accessories`, `tech-accessories`, `wallets-and-card-holders`, `watches` - `collectibles` → `analog-music`, `comic-books`, `figures`, `food-and-consumer-products`, `homeware`, `other-collectibles`, `pins-and-keychains`, `plushes`, `prints`, `skate-decks`, `sports-equipment`, `toys` - `electronics` → `audio`, `cellphones`, `computer-and-gaming-accessories`, `computer-components`, `gaming-consoles`, `laptops-and-desktops`, `other-electronics`, `small-appliances`, `smart-watches`, `tablets`, `video-games` - `trading-cards` → `sealed-boxes`, `graded-singles`, `ungraded-singles` This set can drift as StockX adds or reorganizes subcategories -- treat it as a snapshot, not a permanently fixed enum, and always prefer the live response over this list.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "categories": [
      {
        "name": "Shoes",
        "slug": "shoes",
        "subcategories": [
          {
            "name": "Boots",
            "slug": "boots"
          },
          {
            "name": "Cleats",
            "slug": "cleats"
          },
          {
            "name": "Sandals",
            "slug": "sandals"
          }
        ]
      },
      {
        "name": "Trading Cards",
        "slug": "trading-cards",
        "subcategories": [
          {
            "name": "Sealed Boxes",
            "slug": "sealed-boxes"
          },
          {
            "name": "Graded Singles",
            "slug": "graded-singles"
          },
          {
            "name": "Ungraded Singles",
            "slug": "ungraded-singles"
          }
        ]
      }
    ]
  }
}

Endpoint Playground

Try the StockX category/subcategory taxonomy API

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

What a live request returned

14 Oct 2026: 7 categories; 3 fields had a value in every checked item.

Observed request: GET /stockx/categories
Fields with a value in every checked item: name, slug, subcategories

Sample value profiles: name: “Sneakers” and 6 other values; subcategories: median 11 entries.

Request: GET /stockx/categories
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.84 s
Monitored request: GET /stockx/categories

StockX category/subcategory taxonomy API documentation StockX platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/stockx/categories' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

No request parameters

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "categories": [
      {
        "name": "Shoes",
        "slug": "shoes",
        "subcategories": [
          {
            "name": "Boots",
            "slug": "boots"
          },
          {
            "name": "Cleats",
            "slug": "cleats"
          },
          {
            "name": "Sandals",
            "slug": "sandals"
          }
        ]
      },
      {
        "name": "Trading Cards",
        "slug": "trading-cards",
        "subcategories": [
          {
            "name": "Sealed Boxes",
            "slug": "sealed-boxes"
          },
          {
            "name": "Graded Singles",
            "slug": "graded-singles"
          },
          {
            "name": "Ungraded Singles",
            "slug": "ungraded-singles"
          }
        ]
      }
    ]
  }
}

More StockX endpoints

Get StockX brand catalog Get StockX product detail Get StockX upcoming release calendar Search/browse StockX products

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requeststockx.categoriesResponseDocStockX

GET /stockx/categories

Get StockX category/subcategory taxonomy

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

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "categories": [
      {
        "name": "Shoes",
        "slug": "shoes",
        "subcategories": [
          {
            "name": "Boots",
            "slug": "boots"
          },
          {
            "name": "Cleats",
            "slug": "cleats"
          },
          {
            "name": "Sandals",
            "slug": "sandals"
          }
        ]
      },
      {
        "name": "Trading Cards",
        "slug": "trading-cards",
        "subcategories": [
          {
            "name": "Sealed Boxes",
            "slug": "sealed-boxes"
          },
          {
            "name": "Graded Singles",
            "slug": "graded-singles"
          },
          {
            "name": "Ungraded Singles",
            "slug": "ungraded-singles"
          }
        ]
      }
    ]
  }
}