---
title: "List Grailed's facet taxonomy"
method: GET
path: "/grailed/categories"
tags: ["Grailed"]
---

# List Grailed's facet taxonomy

`GET /grailed/categories`

## Request

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

Returns Grailed's full facet taxonomy for the enum-like parameters grailed-search/grailed-sold-listings accept: department, category, category_path (a more granular subcategory slug), condition, color, and size, each with its own live listing count. department and condition are exhaustive closed sets (2 and 5 values respectively); category/category_path/color/size are the full, exhaustive value space as of the request. Designer is NOT included here (7,363 values, far too large for a facet-count response) -- see grailed-designers for that discovery endpoint.

## Headers

- `x-api-key` string, required

## Response `200`

OK

- GrailedCategoriesResponseDoc
  - `code` integer
  - `data` GrailedCategoriesResponse
    - `categories` GrailedFacetCount[]
      - `count` integer
      - `value` string
    - `category_paths` GrailedFacetCount[]
      - `count` integer
      - `value` string
    - `colors` GrailedFacetCount[]
      - `count` integer
      - `value` string
    - `conditions` GrailedFacetCount[]
      - `count` integer
      - `value` string
    - `departments` GrailedFacetCount[]
      - `count` integer
      - `value` string
    - `fetched_at` string
    - `sizes` GrailedFacetCount[]
      - `count` integer
      - `value` string
  - `msg` string

## Other responses

- `429`: Too Many Requests
- `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/afac9b012a27?raw)