Zalando Brands API returns the brands of a country store with the key that the brand filter of the search takes. Find a brand with query, page with page and per_page. A main brand lists the keys of its sub brands in sub_brand_keys. 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.
4 optional filters 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
string
Optional
Text to find in the brand name. Example: nike.
coffee shops
integer
Optional
One-based page number (default 1).
1
integer
Optional
Brands per page, 1 to 500 (default 100).
10
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"brands": [
{
"key": "NIKE",
"name": "Nike",
"sub_brand_keys": [
"N12",
"NI4",
"NI1"
]
}
],
"country": "de",
"pagination": {
"page": 1,
"per_page": 100,
"has_next_page": false,
"total_results": 9
}
},
"meta": {
"credits": 1,
"billable": true,
"endpoint_family": "brands"
},
"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": "brands"
},
"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.