docs / zalando

Zalando API

base /zalando/v110 endpoints

post/zalando/v1/search1 credit

Search Zalando by keyword — returns product cards with name, brand, SKU, price, color, images and product URL. Filterable by brand, price range and category; paginated.

Parameter		Allowed / range	Description
q	required	—	Search keyword.
country = de	optional	de · uk · gb · fr · nl · it · es · pl	Zalando country edition (TLD) — sets language and currency.
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.
category	optional	—	Optional category slug to scope the search to.
order	optional	popularity · price · price_desc · newest · sale	Sort order.
brand	optional	—	Filter by brand (slugified), e.g. nike-sportswear.
min_price	optional	—	Minimum price (store currency).
max_price	optional	—	Maximum price (store currency).

Try in playground →

post/zalando/v1/category1 credit

Browse Zalando products by category (e.g. herrenschuhe-sneaker) — returns listing cards with name, brand, price and images. Filterable and paginated.

Parameter		Allowed / range	Description
category	required	—	Zalando category slug, e.g. herrenschuhe-sneaker (discover via the categories action).
country = de	optional	de · uk · gb · fr · nl · it · es · pl	Zalando country edition (TLD) — sets language and currency.
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.
order	optional	popularity · price · price_desc · newest · sale	Sort order.
brand	optional	—	Filter by brand (slugified), e.g. nike-sportswear.
min_price	optional	—	Minimum price (store currency).
max_price	optional	—	Maximum price (store currency).

Try in playground →

post/zalando/v1/product1 credit

Full Zalando product detail by URL or SKU — name, brand, price, color, gallery images, available sizes, rating and attributes.

Parameter		Allowed / range	Description
url	optional	—	Full Zalando product URL (.html). (product needs url OR sku.)
sku	optional	—	Zalando SKU, e.g. NI112N022-A11 (resolved from url when omitted).
country = de	optional	de · uk · gb · fr · nl · it · es · pl	Zalando country edition (TLD) — sets language and currency.

Try in playground →

post/zalando/v1/similar1 credit

Products similar to a given Zalando item — pulled from the product page recommendation cards.

Parameter		Allowed / range	Description
url	optional	—	Full Zalando product URL (.html). (product needs url OR sku.)
sku	optional	—	Zalando SKU, e.g. NI112N022-A11 (resolved from url when omitted).
country = de	optional	de · uk · gb · fr · nl · it · es · pl	Zalando country edition (TLD) — sets language and currency.

Try in playground →

post/zalando/v1/variants1 credit

All size variants for a Zalando product with in-stock flags — useful for monitoring stock availability.

Parameter		Allowed / range	Description
url	optional	—	Full Zalando product URL (.html). (product needs url OR sku.)
sku	optional	—	Zalando SKU, e.g. NI112N022-A11 (resolved from url when omitted).
country = de	optional	de · uk · gb · fr · nl · it · es · pl	Zalando country edition (TLD) — sets language and currency.

Try in playground →

post/zalando/v1/brands1 credit

List all distinct brands available in a Zalando category or keyword search — useful for building brand filter dropdowns.

Parameter		Allowed / range	Description
country = de	optional	de · uk · gb · fr · nl · it · es · pl	Zalando country edition (TLD) — sets language and currency.
category	optional	—	Category slug to collect brands from (defaults to a sneaker category).
q	optional	—	Keyword to collect brands from instead of a category.

Try in playground →

post/zalando/v1/categories1 credit

Top-level Zalando category links for a country — men, women, kids and sub-categories like sneakers, dresses or jackets.

Parameter		Allowed / range	Description
country = de	optional	de · uk · gb · fr · nl · it · es · pl	Zalando country edition (TLD) — sets language and currency.
gender	optional	—	Optional gender to filter seeds (e.g. women, men, kids).

Try in playground →

post/zalando/v1/filters1 credit

Discover which sort and filter options are available for Zalando listings, including price range, brand and sort order.

Parameter		Allowed / range	Description
country = de	optional	de · uk · gb · fr · nl · it · es · pl	Zalando country edition (TLD) — sets language and currency.
category	optional	—	Category to live-probe sort behaviour against.
q	optional	—	Keyword context (optional).

Try in playground →

post/zalando/v1/reviews1 credit

Customer reviews and overall rating summary for a Zalando product (when reviews are embedded on the product page).

Parameter		Allowed / range	Description
url	optional	—	Full Zalando product URL (.html). (product needs url OR sku.)
sku	optional	—	Zalando SKU, e.g. NI112N022-A11 (resolved from url when omitted).
country = de	optional	de · uk · gb · fr · nl · it · es · pl	Zalando country edition (TLD) — sets language and currency.

Try in playground →

post/zalando/v1/attributes1 credit

Product attribute clusters for a Zalando item — material composition, care instructions and other structured attributes from the product page.

Parameter		Allowed / range	Description
url	optional	—	Full Zalando product URL (.html). (product needs url OR sku.)
sku	optional	—	Zalando SKU, e.g. NI112N022-A11 (resolved from url when omitted).
country = de	optional	de · uk · gb · fr · nl · it · es · pl	Zalando country edition (TLD) — sets language and currency.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/zalando/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"q":"nike","country":"de"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}