Endpoint Playground
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.
14 Oct 2026: 128 category_paths; 2 fields had a value in every checked item.
Sample value profiles: count: 234 to 1,821,157, median 29,175; value: “tops.short_sleeve_shirts” and 127 other values.
curl 'https://api.crawlora.net/api/v1/grailed/categories' \
-H "x-api-key: $CRAWLORA_API_KEY"No request parameters
{
"code": 200,
"msg": "OK",
"data": {
"departments": [
{
"value": "menswear",
"count": 7567001
},
{
"value": "womenswear",
"count": 3213103
}
],
"categories": [
{
"value": "tops",
"count": 3585831
},
{
"value": "bottoms",
"count": 1441533
},
{
"value": "footwear",
"count": 495891
}
],
"category_paths": [
{
"value": "tops.short_sleeve_shirts",
"count": 200000
},
{
"value": "footwear.low_top_sneakers",
"count": 100000
}
],
"conditions": [
{
"value": "is_used",
"count": 4516431
},
{
"value": "is_gently_used",
"count": 3552087
},
{
"value": "is_new",
"count": 2642253
},
{
"value": "is_worn",
"count": 68671
},
{
"value": "is_not_specified",
"count": 1802
}
],
"colors": [
{
"value": "black",
"count": 3000000
},
{
"value": "white",
"count": 1500000
}
],
"sizes": [
{
"value": "m",
"count": 900000
},
{
"value": "l",
"count": 800000
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.