--- title: "Zalando API: JSON data, 4 endpoints, 1 credit per call" description: "Zalando API for product search by country, brand, size and price, product details with stock levels, brands and categories as JSON. 1 credit per call." url: https://perceptlayer.com/apis/zalando --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / Zalando 1 credit per call 4 endpoints 13 datapoints # Zalando API Zalando API for product search by country, brand, size and price, product details with stock levels, brands and categories as JSON. 1 credit per call. [Get a free API key](https://perceptlayer.com/signup) Run it below Zalando GET /v1/zalando/search?query=sneaker&country=de&sort=price\_asc&sale=true ``` { "success": true, "data": { "country": "de", "currency": "EUR", "products": [ { "sku": "3KU81F06K-B11", "name": "HALF-IN-SHOE - Sneaker-Socken - puder", "model": "HALF-IN-SHOE", "brand": { "id": "3KU", "name": "KUNERT" }, "url": "https://www.zalando.de/kunert-half-in-shoe-socken-puder-3ku81f06k-b11.html", "image": "https://img01.ztat.net/article/spp-media-p1/08f4c88905be454596f29c58916a1282/7b415e82bd684a8c9d6b095a269fc484.jpg?imwidth=780", "images": [ "https://img01.ztat.net/article/spp-media-p1/08f4c88905be454596f29c58916a1282/7b415e82bd684a8c9d6b095a269fc484.jpg?imwidth=780", "https://img01.ztat.net/article/spp-media-p1/02e12e1ba30645b1a52db09c1dae8705/a5c846e21dcb4999a482c98b8d0076f4.jpg?imwidth=780" ], "price": { "current": 5, "original": 6, "currency": "EUR", "on_sale": true, "discount_percent": 16.7, "discount_amount": 1, "prior_price": 6 }, "sizes": [ { "size": "39-42", "sku": "3KU81F06K-B110394000" } ], "flags": [ { "kind": "deal", "label": "Deal" } ], "is_designer": false, "target_group": "women", "silhouette": "stocking" }, { "sku": "4HU81F02D-Q11", "name": "BALLERINA FOOTLET - Sneaker-Socken - black", "model": "BALLERINA FOOTLET", "brand": { "id": "4HU", "name": "Hudson" }, "url": "https://www.zalando.de/hudson-ballerina-footlet-fuesslinge-black-4hu81f02d-q11.html", "image": "https://img01.ztat.net/article/spp-media-p1/fc2e0c33ea6648b09cd1cb143ec2bb95/fe3aea3cf7a647a1bc8c0dcbd9a59691.jpg?imwidth=780", "images": [ "https://img01.ztat.net/article/spp-media-p1/fc2e0c33ea6648b09cd1cb143ec2bb95/fe3aea3cf7a647a1bc8c0dcbd9a59691.jpg?imwidth=780", "https://img01.ztat.net/article/spp-media-p1/407e15a5beac4b1cb285bb3e45fd20fe/20d3851fa726426e886ebe1dbb4ce00d.jpg?imwidth=780" ], "price": { "current": 5.79, "original": 7, "currency": "EUR", "on_sale": true, "discount_percent": 17.3, "discount_amount": 1.21 }, "sizes": [ { "size": "35-36", "sku": "4HU81F02D-Q11000I000" }, { "size": "39-40", "sku": "4HU81F02D-Q110III000" } ], "flags": [ { "kind": "deal", "label": "Deal" } ], "is_designer": false, "target_group": "women", "silhouette": "stocking" }, { "sku": "4HU81F02C-A11", "name": "MOKASSIN FOOTLET - Sneaker-Socken - white", "model": "MOKASSIN FOOTLET", "brand": { "id": "4HU", "name": "Hudson" }, "url": "https://www.zalando.de/hudson-mokassin-fuesslinge-white-4hu81f02c-a11.html", "image": "https://img01.ztat.net/article/spp-media-p1/3eb6e22e933a43cd8aa4764dfe3b1f3a/7174343ea29449d4a38d0d954921ec89.jpg?imwidth=780", "images": [ "https://img01.ztat.net/article/spp-media-p1/3eb6e22e933a43cd8aa4764dfe3b1f3a/7174343ea29449d4a38d0d954921ec89.jpg?imwidth=780", "https://img01.ztat.net/article/spp-media-p1/4dfbae3ba41c42fba01787245e1080de/d325d73bcc3f460eb0a796de99023d6a.jpg?imwidth=780" ], "price": { "current": 5.79, "original": 7, "currency": "EUR", "on_sale": true, "discount_percent": 17.3, "discount_amount": 1.21 }, "sizes": [ { "size": "35-36", "sku": "4HU81F02C-A11000I000" }, { "size": "39-40", "sku": "4HU81F02C-A110III000" } ], "flags": [ { "kind": "deal", "label": "Deal" } ], "is_designer": false, "target_group": "women", "silhouette": "stocking" } ], "pagination": { "page": 1, "per_page": 84, "total_pages": 360, "total_results": 30167, "total_results_capped": false, "has_next_page": true, "unavailable_skipped": 0 }, "sort": "price_asc", "categories": [ { "key": "damen", "name": "Damen", "results": 18653 }, { "key": "herren", "name": "Herren", "results": 13351 }, { "key": "kinder", "name": "Kinder", "results": 4347 } ], "facets": [ { "key": "sizes", "label": "Größe", "type": "discrete", "selected": false, "options": [ { "key": "17", "label": "17", "selected": false }, { "key": "18", "label": "18", "selected": false }, { "key": "18.5", "label": "18.5", "selected": false } ] }, { "key": "brands", "label": "Marke", "type": "discrete", "selected": false, "options": [ { "key": "AI1", "label": "A.S.98", "selected": false }, { "key": "ACG", "label": "ACBC", "selected": false }, { "key": "ADID", "label": "adidas", "selected": false } ] }, { "key": "colors", "label": "Farbe", "type": "discrete", "selected": false, "options": [ { "key": "BLACK", "label": "Schwarz", "selected": false }, { "key": "BROWN", "label": "Braun", "selected": false }, { "key": "BEIGE", "label": "Beige", "selected": false } ] } ] }, "meta": { "endpoint_family": "search", "request_id": "req_93ff34e57d974833a4b1d4d7ebe30caf", "credits_charged": 1, "credits_remaining": 1927 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | sku string | name string | model string | brand object | url url | image url | images string\[\] | price object | sizes object\[\] | flags object\[\] | is\_designer boolean | target\_group string | silhouette string | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 3KU81F06K-B11 | HALF-IN-SHOE - Sneaker-Socken - puder | HALF-IN-SHOE | {2 fields} | https://www.zalando.de/kunert-half-in-shoe-socken-puder-3ku81f06k-b11.html | https://img01.ztat.net/article/spp-media-p1/08f4c88905be454596f29c58916a1282/7b415e82bd684a8c9d6b095a269fc484.jpg?imwidth=780 | \[2 items\] | {7 fields} | \[1 item\] | \[1 item\] | false | women | stocking | | 2 | 4HU81F02D-Q11 | BALLERINA FOOTLET - Sneaker-Socken - black | BALLERINA FOOTLET | {2 fields} | https://www.zalando.de/hudson-ballerina-footlet-fuesslinge-black-4hu81f02d-q11.html | https://img01.ztat.net/article/spp-media-p1/fc2e0c33ea6648b09cd1cb143ec2bb95/fe3aea3cf7a647a1bc8c0dcbd9a59691.jpg?imwidth=780 | \[2 items\] | {6 fields} | \[2 items\] | \[1 item\] | false | women | stocking | | 3 | 4HU81F02C-A11 | MOKASSIN FOOTLET - Sneaker-Socken - white | MOKASSIN FOOTLET | {2 fields} | https://www.zalando.de/hudson-mokassin-fuesslinge-white-4hu81f02c-a11.html | https://img01.ztat.net/article/spp-media-p1/3eb6e22e933a43cd8aa4764dfe3b1f3a/7174343ea29449d4a38d0d954921ec89.jpg?imwidth=780 | \[2 items\] | {6 fields} | \[2 items\] | \[1 item\] | false | women | stocking | Recorded from our API · 3 items shown · 13 datapoints per item GET /v1/zalando/search?query=sneaker&country=de&sort=price\_asc&sale=true 13 datapoints ### Identity - sku string - name string - brand object ### Contact - url url ### Reputation - image url - images string\[\] ### Price - price object ### Other - model string - sizes object\[\] - flags object\[\] - is\_designer boolean - target\_group string - silhouette string Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/zalando/search?query=sneaker&country=de&sort=price_asc&sale=true" \ -H "X-API-Key: $API_KEY" ``` Zalando · 4 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/zalando/brands`](https://perceptlayer.com/apis/zalando/brands) | none +4 optional | 1 credit | | [GET `/v1/zalando/categories`](https://perceptlayer.com/apis/zalando/categories) | none +1 optional | 1 credit | | [GET `/v1/zalando/product`](https://perceptlayer.com/apis/zalando/product) | none +4 optional | 1 credit | | [GET `/v1/zalando/search`](https://perceptlayer.com/apis/zalando/search) | none +14 optional | 1 credit | Overview ## About the Zalando API ## What you can get The Zalando API returns Zalando shop data as JSON through 4 endpoints. Each takes a `country` (de, at, ch, nl, be, fr, it, es, pl, uk, ie, se, cz, dk, no or fi). - **Search:** `search` takes a `query` or a `category`, with `page`, `sort` (popularity, price\_asc, price\_desc, new\_in or sale), `brand`, `size`, `color`, `filters`, `price_min`, `price_max`, `sale`, `condition` (new or pre\_owned) and `gender` (women or men). - **Products:** `product` takes a `sku` or a product `url`, with `include` set to stock\_levels. - **Brands and categories:** `brands` takes an optional `query`, with `page` and `per_page`; `categories` lists a country's categories. The recorded search for "sneaker" in de, sorted by price\_asc with `sale=true`, returns `products`, each with `sku`, `name`, `model`, `brand`, `url`, `images`, `price` ( `current`, `original`, `on_sale`, `discount_percent` and `prior_price`), `sizes`, `flags`, `target_group` and `silhouette`. It also returns `pagination` with `total_results` (30167 in that recording), `total_pages` and `has_next_page`, plus `categories` and `facets`. ## How a call works Search a country, then look up: `GET /v1/zalando/search?query=sneaker&country=de&sort=price_asc&sale=true` with your key in the `X-API-Key` header. Each product carries a `sku`; `product` takes that `sku`, and `include=stock_levels` adds stock. Every successful call costs 1 credit; failed calls cost nothing. Marketplaces JSON REST MCP ### More marketplaces APIs [About You](https://perceptlayer.com/apis/about-you) [adidas](https://perceptlayer.com/apis/adidas) [AliExpress](https://perceptlayer.com/apis/aliexpress) [Allegro](https://perceptlayer.com/apis/allegro) [Amazon](https://perceptlayer.com/apis/amazon) [ASOS](https://perceptlayer.com/apis/asos) [Billiger.de](https://perceptlayer.com/apis/billiger) [bol.com](https://perceptlayer.com/apis/bol) [Chrono24](https://perceptlayer.com/apis/chrono24) [Costco](https://perceptlayer.com/apis/costco) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) Use cases ### Track prices and discounts for a product list across Zalando countries `Use the Zalando API to track prices and discounts for a product list across Zalando countries` ### Compare one product's price between countries `Use the Zalando API to compare one product's price between countries` ### Watch stock levels for a SKU `Use the Zalando API to watch stock levels for a SKU` ### Monitor sale products for a brand or category `Use the Zalando API to monitor sale products for a brand or category` FAQ ## Questions **How much does the Zalando API cost?** Each successful call costs one credit, including \`product\` with stock levels. New accounts get free credits to start, and credit packs bring the price down as you scale. **Which Zalando countries can I query?** Sixteen: de, at, ch, nl, be, fr, it, es, pl, uk, ie, se, cz, dk, no and fi, set with \`country\`. **Do I need a Zalando account?** No. You call this Zalando API with your Perceptlayer key in the \`X-API-Key\` header, with no Zalando login. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Should I build a Zalando scraper instead?** You can, but a Zalando scraper is code you maintain: page changes break it, requests get blocked, and Zalando's terms govern how you collect data. The Zalando API gives you 4 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the Zalando API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)