Trendyol Filters API returns the filter values of a search: brands with ids and counts, colors, genders, categories, price steps, rating steps, sizes and attribute filters such as material or collar. Use the brand and category ids in the Trendyol Search API.
The lists belong to the search text and are cached for six hours. Sizes are listed for information: the search has no size filter.
Costs 1 credit per successful request. Empty results and failed requests are free.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
string
Required
Search text, 1 to 120 characters, for example elbise.
coffee shops
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"query": "elbise",
"sizes": [
{
"id": "group-xs",
"name": "XS",
"count": 22252
},
{
"id": "group-s",
"name": "S",
"count": 132776
},
{
"id": "group-m",
"name": "M",
"count": 130109
}
],
"brands": [
{
"id": "41",
"name": "MANGO",
"count": 1159
},
{
"id": "147",
"name": "Stradivarius",
"count": 77
},
{
"id": "38",
"name": "Koton",
"count": 4147
}
],
"colors": [
{
"id": "1",
"name": "Alt\u0131n",
"count": 2341
},
{
"id": "2",
"name": "Bej",
"count": 16923
},
{
"id": "3",
"name": "Beyaz",
"count": 22173
}
],
"genders": [
{
"id": "1",
"name": "Kad\u0131n",
"count": 430537
},
{
"id": "2",
"name": "Erkek",
"count": 527
},
{
"id": "3",
"name": "\u00c7ocuk",
"count": 53632
}
],
"ratings": [
{
"id": "4.5",
"name": "4.5 Y\u0131ld\u0131z Ve \u00dczeri",
"count": 53325
},
{
"id": "4",
"name": "4 Y\u0131ld\u0131z Ve \u00dczeri",
"count": 27166
},
{
"id": "3",
"name": "3 Y\u0131ld\u0131z Ve \u00dczeri",
"count": 23275
},
{
"id": "2",
"name": "2 Y\u0131ld\u0131z Ve \u00dczeri",
"count": 6070
},
{
"id": "1",
"name": "1 Y\u0131ld\u0131z Ve \u00dczeri",
"count": 6977
}
],
"attributes": [
{
"name": "Materyal",
"values": [
{
"id": "212262",
"name": "%100 Pamuk",
"count": 12080
},
{
"id": "1225813",
"name": "%100 Viskoz",
"count": 318
},
{
"id": "1178534",
"name": "3 \u0130plik \u015eardonlu",
"count": 424
}
]
}
],
"categories": [
{
"id": "56",
"name": "Elbise",
"count": 491989
}
],
"price_ranges": [
{
"id": "0-600",
"name": "0 TL - 600 TL",
"count": 0
},
{
"id": "600-1250",
"name": "600 TL - 1250 TL",
"count": 0
},
{
"id": "1250-1750",
"name": "1250 TL - 1750 TL",
"count": 0
},
{
"id": "1750-2500",
"name": "1750 TL - 2500 TL",
"count": 0
},
{
"id": "2500-7000",
"name": "2500 TL - 7000 TL",
"count": 0
},
{
"id": "7000-900000",
"name": "7000 TL - 900000 TL",
"count": 0
}
]
},
"meta": {
"credits": 1,
"billable": true,
"endpoint_family": "filters"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required parameter or a value is invalid. This response is not billable.
{
"errors": {
"query": [
"A search text is required, e.g. elbise."
]
},
"message": "The request validation failed"
}Upstream Unavailable
Trendyol could not be reached after several tries. This response is not billable. Retry shortly.
{
"meta": {
"credits": 0,
"billable": false,
"retryable": true,
"endpoint_family": "filters"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Trendyol could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.