# Zalando Shop API

> Zalando Shop API on Apizie: 20 endpoints (Get Article Reviews, Get Article Reviews Summaries, Get Article Reviews Summaries by articleModelId, Get Article Reviews by reviewId, …) returned as clean JSON through one API key. 20 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/ecommerce:zalando/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `ecommerce:zalando`
- Category: E-commerce
- Status: live
- Source: https://zalando.com
- Page: https://zieapi.vercel.app/api/ecommerce/zalando
- OpenAPI: https://zieapi.vercel.app/api/ecommerce/zalando/openapi.json

The shop API empowers developers to build amazing new apps or websites using Zalando shop data and services.

## Endpoints

### Get Article Reviews
`GET https://zieapi.vercel.app/v1/ecommerce:zalando/get-article-reviews`

| Parameter | Type | Required | Description |
|---|---|---|---|
| articleId | array | no | Article IDs. A list of config SKUs for which the article reviews will be returned. Required if articleModelId is empty. |
| articleModelId | array | no | Article model IDs. A list of model SKUs for which the article reviews will be returned. Required if articleId is empty. |
| minStarRating | string | no | To get reviews with minimum star rating. |
| maxStarRating | string | no | To get reviews with maximum star rating. |
| sort | string | no | articles are sorted on reviews provided by customers (eg: best) |
| page | string | no | to request with required page number or pagination |
| pageSize | string | no | to request with required page size in a page |
| Accept-Language | string | no | Specify which Shop to use. A standard `Accept-Language` header which specifies the shop that should be used. E.g. `de-DE` will use the… |
| fields | array | no | Comma separated list of fields that should be returned. Fields of subobjects are specified with dots as separator. Fields of objects… |

### Get Article Reviews Summaries
`GET https://zieapi.vercel.app/v1/ecommerce:zalando/get-article-reviews-summaries`

| Parameter | Type | Required | Description |
|---|---|---|---|
| articleModelId | array | yes | Article model IDs. A list of model SKUs for which the article review summaries will be returned. |
| page | string | no | to request with required page number or pagination |
| pageSize | string | no | to request with required page size in a page |
| Accept-Language | string | no | Specify which Shop to use. A standard `Accept-Language` header which specifies the shop that should be used. E.g. `de-DE` will use the… |
| fields | array | no | Comma separated list of fields that should be returned. Fields of subobjects are specified with dots as separator. Fields of objects… |

### Get Article Reviews Summaries by articleModelId
`GET https://zieapi.vercel.app/v1/ecommerce:zalando/get-article-reviews-summaries-article-model-id`

| Parameter | Type | Required | Description |
|---|---|---|---|
| articleModelId | string | yes | To get unique reviews summary from article model Id. |
| Accept-Language | string | no | Specify which Shop to use. A standard `Accept-Language` header which specifies the shop that should be used. E.g. `de-DE` will use the… |
| fields | array | no | Comma separated list of fields that should be returned. Fields of subobjects are specified with dots as separator. Fields of objects… |

### Get Article Reviews by reviewId
`GET https://zieapi.vercel.app/v1/ecommerce:zalando/get-article-reviews-review-id`

| Parameter | Type | Required | Description |
|---|---|---|---|
| reviewId | string | yes | To get unique review by review Id. |
| Accept-Language | string | no | Specify which Shop to use. A standard `Accept-Language` header which specifies the shop that should be used. E.g. `de-DE` will use the… |
| fields | array | no | Comma separated list of fields that should be returned. Fields of subobjects are specified with dots as separator. Fields of objects… |

### Search for Articles
`GET https://zieapi.vercel.app/v1/ecommerce:zalando/get-articles`

| Parameter | Type | Required | Description |
|---|---|---|---|
| articleId | array | no | The `articleIds` to use use for filtering. One or more `articleIds` might be used as a filter criteria. Submit multiple `articleId`… |
| articleModelId | array | no | filters by article ModelId |
| articleUnitId | array | no | filters by article's unit id |
| activationDate | array | no | period or time the articles are activated for selling in the shop |
| ageGroup | array | no | filters by age group (eg: kids) |
| assortmentArea | array | no | filters by classification of articles (eg: maternity) |
| brand | array | no | filters by brand key given by user (eg: SA5) |
| brandfamily | array | no | filters by brand family key (eg: nike) |
| category | array | no | filters by category (eg: Socks, Rain Coats) |
| color | array | no | filters by color (eg: red, blue) |
| den | array | no | filters by den |
| filling | array | no | filters by different kinds of garment filling materials (eg: satin, wolle) |
| fullText | string | no | filters by text (eg: search by 'as' gives result with articles of brand Sass) |
| gender | array | no | filters by gender |
| heelForm | array | no | filters by heel form (eg: flat) |
| heelHeight | array | no | filters by height of the heel size or length (eg: xs) |
| length | string | no | filters by garments length (eg: 3/4 length, knee-length) |
| occasion | array | no | filters by type of occasion (eg: party, business) |
| pattern | array | no | filters by pattern on the garments (eg: animal print, plain) |
| price | string | no | filters all articles in price range (eg: 9-90) |
| sale | array | no | filters discounted articles marked as sale |
| season | array | no | filters by season (Autumn/Winter or Spring/Summer) |
| shaftHeight | array | no | filters by shaft height (eg: s, xs) |
| shaftWidth | array | no | filters by shaft width (eg: s, l) |
| shirtCollar | array | no | filters by shirt collar styles (eg: low V neck, lined collar) |
| shoeFastener | array | no | filters by shoe fastener types (eg: buckle, lacing) |
| shoeToecap | array | no | filters by shoe toe cap variants (eg: pointed, square) |
| shopArea | array | no | filters by classification of articles |
| size | string | no | filters by size |
| sports | array | no | filters by different sport activities (eg: football) |
| technology | array | no | filters by technology used to produce the articles |
| trouserRise | array | no | filters by trouser rise |
| upperMaterial | array | no | filters by different type of upper material used on garments (eg: lace) |
| volume | array | no | filters by volume |
| page | string | no | to request with required page number or pagination |
| pageSize | string | no | to request with required page size in a page |
| sort | string | no | sorting order (eg: popularity) |
| Accept-Language | string | no | Specify which Shop to use. A standard `Accept-Language` header which specifies the shop that should be used. E.g. `de-DE` will use the… |
| fields | array | no | Comma separated list of fields that should be returned. Fields of subobjects are specified with dots as separator. Fields of objects… |

### Get Article by articleId
`GET https://zieapi.vercel.app/v1/ecommerce:zalando/get-articles-article-id`

| Parameter | Type | Required | Description |
|---|---|---|---|
| articleId | string | yes | To get unique article for article Id. |
| Accept-Language | string | no | Specify which Shop to use. A standard `Accept-Language` header which specifies the shop that should be used. E.g. `de-DE` will use the… |
| fields | array | no | Comma separated list of fields that should be returned. Fields of subobjects are specified with dots as separator. Fields of objects… |

### Get Article media by articleId
`GET https://zieapi.vercel.app/v1/ecommerce:zalando/get-articles-article-id-media`

| Parameter | Type | Required | Description |
|---|---|---|---|
| articleId | string | yes | To get unique article for article Id media. |
| Accept-Language | string | no | Specify which Shop to use. A standard `Accept-Language` header which specifies the shop that should be used. E.g. `de-DE` will use the… |
| fields | array | no | Comma separated list of fields that should be returned. Fields of subobjects are specified with dots as separator. Fields of objects… |

### Get Article reviews by articleId
`GET https://zieapi.vercel.app/v1/ecommerce:zalando/get-articles-article-id-reviews`

| Parameter | Type | Required | Description |
|---|---|---|---|
| articleId | string | yes | To get unique article for article Id reviews. |
| minStarRating | string | no | To get reviews with minimum star rating. |
| maxStarRating | string | no | To get reviews with maximum star rating. |
| sort | string | no | articles are sorted on reviews provided by customers (eg: best) |
| page | string | no | to request with required page number or pagination |
| pageSize | string | no | to request with required page size in a page |
| Accept-Language | string | no | Specify which Shop to use. A standard `Accept-Language` header which specifies the shop that should be used. E.g. `de-DE` will use the… |
| fields | array | no | Comma separated list of fields that should be returned. Fields of subobjects are specified with dots as separator. Fields of objects… |

### Get Article reviews summary by articleId
`GET https://zieapi.vercel.app/v1/ecommerce:zalando/get-articles-article-id-reviews-summary`

| Parameter | Type | Required | Description |
|---|---|---|---|
| articleId | string | yes | To get unique article for article Id reviews summary. |
| Accept-Language | string | no | Specify which Shop to use. A standard `Accept-Language` header which specifies the shop that should be used. E.g. `de-DE` will use the… |
| fields | array | no | Comma separated list of fields that should be returned. Fields of subobjects are specified with dots as separator. Fields of objects… |

### Get Article units by articleId
`GET https://zieapi.vercel.app/v1/ecommerce:zalando/get-articles-article-id-units`

| Parameter | Type | Required | Description |
|---|---|---|---|
| articleId | string | yes | To get unique article for article Id units. |
| Accept-Language | string | no | Specify which Shop to use. A standard `Accept-Language` header which specifies the shop that should be used. E.g. `de-DE` will use the… |
| fields | array | no | Comma separated list of fields that should be returned. Fields of subobjects are specified with dots as separator. Fields of objects… |

### Get Article units by articleId snd unitId
`GET https://zieapi.vercel.app/v1/ecommerce:zalando/get-articles-article-id-units-unit-id`

| Parameter | Type | Required | Description |
|---|---|---|---|
| articleId | string | yes | To get unique article for article Id. |
| unitId | string | yes | To get unique article for article Id unit. |
| Accept-Language | string | no | Specify which Shop to use. A standard `Accept-Language` header which specifies the shop that should be used. E.g. `de-DE` will use the… |
| fields | array | no | Comma separated list of fields that should be returned. Fields of subobjects are specified with dots as separator. Fields of objects… |

### Shop Brands
`GET https://zieapi.vercel.app/v1/ecommerce:zalando/get-brands`

| Parameter | Type | Required | Description |
|---|---|---|---|
| key | array | no | Request Brand by key |
| name | array | no | Request Brand by name |
| brandFamilyName | array | no | Request Brand by brandFamilyName |
| brandFamilyKey | array | no | Request Brand by brandFamilyKey |
| page | string | no | to request with required page number or pagination |
| pageSize | string | no | to request with required page size in a page |
| Accept-Language | string | no | Specify which Shop to use. A standard `Accept-Language` header which specifies the shop that should be used. E.g. `de-DE` will use the… |
| fields | array | no | Comma separated list of fields that should be returned. Fields of subobjects are specified with dots as separator. Fields of objects… |

### Get Single Brand by Key
`GET https://zieapi.vercel.app/v1/ecommerce:zalando/get-brands-key`

| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | yes | To get unique Brand by key. |
| Accept-Language | string | no | Specify which Shop to use. A standard `Accept-Language` header which specifies the shop that should be used. E.g. `de-DE` will use the… |
| fields | array | no | Comma separated list of fields that should be returned. Fields of subobjects are specified with dots as separator. Fields of objects… |

### Shop Categories
`GET https://zieapi.vercel.app/v1/ecommerce:zalando/get-categories`

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | array | no | Request Categories by names |
| type | string | no | Request Categories by type |
| outlet | string | no | Request Categories by outlet |
| hidden | string | no | Request Categories by hidden |
| targetGroup | string | no | Request Categories by target group |
| key | array | no | Request Categories by keys |
| parentKey | array | no | Request Categories by parent keys |
| childKey | array | no | Request Categories by child keys |
| suggestedFilter | array | no | Request Categories by suggested filters |
| page | string | no | to request with required page number or pagination |
| pageSize | string | no | to request with required page size in a page |
| Accept-Language | string | no | Specify which Shop to use. A standard `Accept-Language` header which specifies the shop that should be used. E.g. `de-DE` will use the… |
| fields | array | no | Comma separated list of fields that should be returned. Fields of subobjects are specified with dots as separator. Fields of objects… |

### Get Single Category by Key
`GET https://zieapi.vercel.app/v1/ecommerce:zalando/get-categories-key`

| Parameter | Type | Required | Description |
|---|---|---|---|
| key | array | yes | To get unique Category by key. |
| Accept-Language | string | no | Specify which Shop to use. A standard `Accept-Language` header which specifies the shop that should be used. E.g. `de-DE` will use the… |
| fields | array | no | Comma separated list of fields that should be returned. Fields of subobjects are specified with dots as separator. Fields of objects… |

### Shop Domains
`GET https://zieapi.vercel.app/v1/ecommerce:zalando/get-domains`

### Shop Facets
`GET https://zieapi.vercel.app/v1/ecommerce:zalando/get-facets`

| Parameter | Type | Required | Description |
|---|---|---|---|
| ageGroup | array | no | filters by age group (eg: kids) |
| articleId | array | no | The `articleIds` to use use for filtering. One or more `articleIds` might be used as a filter criteria. Submit multiple `articleId`… |
| activationDate | array | no | period or time the articles are activated for selling in the shop |
| articleModelId | array | no | filters by article ModelId |
| assortmentArea | array | no | filters by classification of articles (eg: maternity) |
| brand | array | no | filters by brand key given by user (eg: SA5) |
| brandfamily | array | no | filters by brand family key (eg: nike) |
| category | array | no | filters by category (eg: Socks, Rain Coats) |
| color | array | no | filters by color (eg: red, blue) |
| den | array | no | filters by den |
| filling | array | no | filters by different kinds of garment filling materials (eg: satin, wolle) |
| gender | array | no | filters by gender |
| heelForm | array | no | filters by heel form (eg: flat) |
| heelHeight | array | no | filters by height of the heel size or length (eg: xs) |
| length | string | no | filters by garments length (eg: 3/4 length, knee-length) |
| occasion | array | no | filters by type of occasion (eg: party, business) |
| pattern | array | no | filters by pattern on the garments (eg: animal print, plain) |
| price | string | no | filters all articles in price range (eg: 9-90) |
| sale | array | no | filters discounted articles marked as sale |
| season | array | no | filters by season (Autumn/Winter or Spring/Summer) |
| shaftHeight | array | no | filters by shaft height (eg: s, xs) |
| shaftWidth | array | no | filters by shaft width (eg: s, l) |
| shirtCollar | array | no | filters by shirt collar styles (eg: low V neck, lined collar) |
| shoeFastener | array | no | filters by shoe fastener types (eg: buckle, lacing) |
| shoeToecap | array | no | filters by shoe toe cap variants (eg: pointed, square) |
| shopArea | array | no | filters by classification of articles |
| size | string | no | filters by size |
| sports | array | no | filters by different sport activities (eg: football) |
| technology | array | no | filters by technology used to produce the articles |
| trouserRise | array | no | filters by trouser rise |
| upperMaterial | array | no | filters by different type of upper material used on garments (eg: lace) |
| volume | array | no | filters by volume |
| Accept-Language | string | no | Specify which Shop to use. A standard `Accept-Language` header which specifies the shop that should be used. E.g. `de-DE` will use the… |
| fields | array | no | Comma separated list of fields that should be returned. Fields of subobjects are specified with dots as separator. Fields of objects… |

### Shop Filters
`GET https://zieapi.vercel.app/v1/ecommerce:zalando/get-filters`

| Parameter | Type | Required | Description |
|---|---|---|---|
| Accept-Language | string | no | Specify which Shop to use. A standard `Accept-Language` header which specifies the shop that should be used. E.g. `de-DE` will use the… |
| fields | array | no | Comma separated list of fields that should be returned. Fields of subobjects are specified with dots as separator. Fields of objects… |

### Get Single Filter by filterName
`GET https://zieapi.vercel.app/v1/ecommerce:zalando/get-filters-filter-name`

| Parameter | Type | Required | Description |
|---|---|---|---|
| filterName | string | yes | To get Filter by filterName. |
| Accept-Language | string | no | Specify which Shop to use. A standard `Accept-Language` header which specifies the shop that should be used. E.g. `de-DE` will use the… |
| fields | array | no | Comma separated list of fields that should be returned. Fields of subobjects are specified with dots as separator. Fields of objects… |

### Get Recommendations by articleId
`GET https://zieapi.vercel.app/v1/ecommerce:zalando/get-recommendations-article-ids`

| Parameter | Type | Required | Description |
|---|---|---|---|
| articleIds | array | yes | To get Recommendations by articleIds. |
| maxResults | string | no | To get maximum results of Recommendations by articleId. |
| Accept-Language | string | no | Specify which Shop to use. A standard `Accept-Language` header which specifies the shop that should be used. E.g. `de-DE` will use the… |
| fields | array | no | Comma separated list of fields that should be returned. Fields of subobjects are specified with dots as separator. Fields of objects… |

## Example
```
curl "https://zieapi.vercel.app/v1/ecommerce:zalando/get-article-reviews" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the Zalando Shop API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/ecommerce:zalando/get-article-reviews with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Zalando Shop API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the Zalando Shop API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key ecommerce:zalando.

### What is the status of the Zalando Shop API?
Live: works with just an Apizie key