Zalando API endpoint
Returns Zalando's own search-box query completions for a partial keyword, e.g. "running sho" -> "running shoes", "running shoes nike". market is required (there is no default storefront) and accepts 25 country storefronts — see zalando-markets for the full current list with domains.
/zalando/suggestReturns Zalando's own search-box query completions for a partial keyword, e.g. running sho -> running shoes, running shoes nike, running shoes adidas. q and market are both required — there is no default storefront. market accepts at, be, ch, cz, de, dk, ee, es, fi, fr, gb, hr, hu, ie, it, lt, lu, lv, nl, no, pl, ro, se, si, sk (see zalando-markets for the full reference list with domains). suggestions is ordered as Zalando itself returns them (most relevant first); an empty list for an obscure query is a valid response, not an error.
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| q | string | Yes | Partial search text to complete | running sho | |
| market | string | Yes | Zalando country storefront Allowed values: at, be, ch, cz, de, dk, ee, es, fi, fr, gb, hr, hu, ie, it, lt, lu, lv, nl, no, pl, ro, se, si, sk. | at | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/zalando/suggest?q=running+sho&market=at" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"query": "running sho",
"market": "de",
"suggestions": [
"running shoes",
"running shoes nike",
"running shoes adidas",
"running shoes new balance",
"running shoes hoka"
],
"source_url": "https://en.zalando.de/api/graphql/",
"fetched_at": "2026-08-04T12:00:00Z"
}
}Request schema
No body schema
Response schema
#/definitions/zalando.suggestResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | zalando.SuggestResponse | No | ||||
| data.fetched_at | string | No | ||||
| data.market | string | No | de | |||
| data.query | string | No | running sho | |||
| data.source_url | string | No | ||||
| data.suggestions | array | No | running shoes,running shoes nike,running shoes adidas | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/zalando/suggest?q=running+sho&market=at" \
-H "x-api-key: $CRAWLORA_API_KEY"