Zalando Categories API returns the category tree of a country store. Each node has a name, its key (pass it as category to the search; groups without a key only hold children) and its children. Category keys are written in the language of the country and differ per country. A few entries are campaign pages that the search refuses with 422. Cost: 1 credit per successful request. Failed requests are not billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
1 optional filter available.
string
Optional
Country store: de (default), at, ch, nl, be, fr, it, es, pl, uk, ie, se, cz, dk, no or fi. SKUs are the same in every country, categories and brand keys are per country.
US
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"country": "de",
"categories": [
{
"key": "damen-home",
"name": "Damen",
"children": [
{
"key": "damenbekleidung",
"name": "Bekleidung",
"children": []
}
]
}
]
},
"meta": {
"credits": 1,
"billable": true,
"endpoint_family": "categories"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing or invalid, a filter or category is unknown for the country, or the answer did not match the request. This response is not billable.
{
"errors": {
"country": [
"The country must be one of de, at, ch, nl, be, fr, it, es, pl, uk, ie, se, cz, dk, no or fi."
]
},
"message": "The request validation failed"
}Upstream Unavailable
Zalando could not be reached or returned data that does not match the request (another page, another sort). This response is not billable and is retryable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "categories"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Zalando 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.