Zara Search API returns 24 products per page for a keyword, or for a whole category when you send category_id. Send either query or category_id. Get category ids from /api/zara/categories. Each item has seo_product_id (send it as id to the product route), color_product_id (the id of the listed colour; the product route does not accept it), section, family, url, availability, price, original_price, sale_price and discount_percent (only when the sale price is below the original price), colours with swatch colour and image, and images. Prices are numbers with an ISO currency.
The section is honoured: a keyword search returns only products of that section (default WOMAN), and a section sent with a category filters it. A page past the last page is rejected with 422, never answered with other data. A category lists one row per product: the colours of a product sit in colors. The Spanish site has no HOME section, so section HOME with country es returns 422. A keyword without a match returns an empty list. Countries: us, de, es, fr, uk. English text. A successful request costs 1 credit.
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.
5 optional filters available.
string
Optional
Search keyword. Required unless category_id is sent.
coffee shops
string
Optional
Numeric Zara category id from /api/zara/categories, for example 2432130 (men jeans in the US). Required unless query is sent.
1234567890
string
Optional
WOMAN (default for a keyword search), MAN, KID or HOME. With a category it filters the list only when sent. HOME does not exist for country es (422).
example
string
Optional
Country: us (default), de, es, fr or uk. Prices use the currency of the country.
US
integer
Optional
One-based page number, 1 to 100 (default 1). A page past the last page is rejected.
1
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"page": 1,
"items": [
{
"url": "https://www.zara.com/us/en/vintage-look-loose-barrel-fit-jeans-p00840449.html",
"name": "VINTAGE-EFFECT LOOSE BARREL-FIT JEANS",
"tags": [],
"price": 99.9,
"colors": [
{
"hex": "#808785",
"name": "Light blue",
"image": "https://static.zara.net/assets/public/c6bf/ae80/3e3148b2871a/3e6df04d4454/00840449406-f1/00840449406-f1.jpg?ts=1791276145628&w=1024",
"price": 99.9,
"color_id": "406",
"availability": "in_stock"
}
],
"family": "TROUSERS",
"images": [
"https://static.zara.net/assets/public/c6bf/ae80/3e3148b2871a/3e6df04d4454/00840449406-f1/00840449406-f1.jpg?ts=1791276145628&w=1024"
],
"section": "MAN",
"currency": "USD",
"reference": "C00840449406000-I2026",
"subfamily": "F. Pants Denim",
"sale_price": null,
"availability": "in_stock",
"original_price": null,
"seo_product_id": "00840449",
"color_product_id": "584981471",
"discount_percent": null
},
{
"url": "https://www.zara.com/us/en/straight-barrel-fit-jeans-p00840355.html",
"name": "STRAIGHT BARREL FIT JEANS",
"tags": [],
"price": 41.94,
"colors": [
{
"hex": "#6D7880",
"name": "Blue",
"image": "https://static.zara.net/assets/public/adc3/0e56/169c4111aa21/ad73ddcd407e/00840355400-e1/00840355400-e1.jpg?ts=1783587590517&w=1024",
"price": 41.94,
"color_id": "400",
"availability": "in_stock"
}
],
"family": "PANTALON",
"images": [],
"section": "MAN",
"currency": "USD",
"reference": "00840355-I2026",
"subfamily": "B. Pant Denim",
"sale_price": 41.94,
"availability": "in_stock",
"original_price": 69.9,
"seo_product_id": "00840355",
"color_product_id": "577969386",
"discount_percent": 40
}
],
"query": "jeans",
"total": 516,
"country": "us",
"section": "MAN",
"has_more": true,
"page_size": 24,
"category_id": null,
"total_pages": 22
},
"meta": {
"credits": 1,
"billable": true,
"endpoint_family": "search"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Not Found
The category does not exist in the chosen country. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "search"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested resource was not found."
},
"success": false
}Validation Error
A parameter is missing or invalid, or a filter cannot be honoured. This response is not billable.
{
"errors": {
"country": [
"The country must be one of us, de, es, fr or uk."
]
},
"message": "The request validation failed"
}Upstream Unavailable
Zara could not be reached, or it returned data that does not match the request (another section, another page, a block page). This response is not billable and is retryable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Zara 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.