Endpoint Playground
Returns the filter facets for a SHEIN search, given the required `keyword` and an optional `cat_id` that narrows them. The response has filter groups (id, name, options), a recursive `category` drill-down with `children`, and the `min_price` and `max_price` for the query.
14 Oct 2026: 15 filters; 3 fields had a value in every checked item.
Sample value profiles: name: “Occasion” and 14 other values; options: median 12 entries.
curl 'https://api.crawlora.net/api/v1/shein/products/aggregation-filters?keyword=dress' \
-H "x-api-key: $CRAWLORA_API_KEY" \
-X POST \
--data '{}'| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| keyword | string | Yes | dress | Free-text search query |
| cat_id | string | No | Numeric SHEIN category id, narrows the facets |
{
"code": 200,
"msg": "OK",
"data": {
"keyword": "dress",
"min_price": "18",
"max_price": "569",
"filters": [
{
"id": "87",
"name": "Size",
"options": [
{
"id": "87_757",
"name": "XXS"
}
]
},
{
"id": "62",
"name": "Composition",
"options": [
{
"id": "62_526",
"name": "Polyester"
}
]
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.