Zara APIzara.com ↗
Access Zara US product catalog, search, categories, size charts, store locations, and shipping info via a structured JSON API. 9 endpoints.
What is the Zara API?
The Zara US API covers 9 endpoints that expose the full Zara US product catalog, including categories, keyword search, detailed product data, size measurements, store locations, and shipping policies. The search_products endpoint accepts a keyword query plus optional section and pagination params, returning price, availability, and color detail for each match. get_product_measurements goes further, returning per-size body measurements in both cm and inches.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/ed974cab-5944-475f-b8d0-6d4249b79493/get_categories' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace zara-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Zara SDK — search products, check sizes, find stores."""
from parse_apis.zara_product__store_api import Zara, Section, ProductNotFound
client = Zara()
# Search for dresses in the women's section
for product in client.products.search(query="dress", section=Section.WOMAN, limit=3):
print(product.name, product.price, product.section_name)
# Drill into a single product's measurements
product = client.products.search(query="jacket", limit=1).first()
if product:
guide = product.measurements.get()
if guide.size_guide_info:
print(guide.size_guide_info.name, guide.size_guide_info.id)
for size in guide.size_guide_info.sizes[:3]:
print(size.id, size.name)
# Get styling recommendations for the product
for rec in product.related.list(limit=2):
print(rec.id, rec.reference)
# Browse a category's products via constructible Category
cat = client.categories.list(limit=1).first()
if cat:
for p in cat.products.list(limit=2):
print(p.name, p.price)
# Find nearby Zara stores in New York
for store in client.stores.search(lat="40.7128", lng="-74.0060", limit=3):
print(store.city, store.zip_code, store.address_lines)
# Get shipping info
shipping = client.shippinginfos.get()
print(shipping.article)
# Typed error handling for product not found
try:
missing = client.products.get(product_id="99999999")
print(missing.name)
except ProductNotFound as exc:
print(f"Product not found: {exc.product_id}")
print("exercised: products.search / measurements.get / related.list / categories.list / category.products.list / stores.search / shippinginfos.get / products.get")
Returns all top-level and sub-level product categories available on Zara US. Categories include section names (WOMAN, MAN, KIDS) and nested subcategories with SEO metadata. Each category has an ID that can be used with get_category_products to fetch products.
No input parameters required.
{
"type": "object",
"fields": {
"categories": "array of category objects with id, key, name, sectionName, subcategories, seo metadata"
},
"sample": {
"data": {
"categories": [
{
"id": 1881757,
"key": "I2024-MUJER",
"name": "WOMAN",
"sectionName": "WOMAN",
"subcategories": [
{
"id": 2546081,
"key": "I2024-MUJER-ULTIMA_SEMANA",
"seo": {
"keyword": "woman-new-in",
"seoCategoryId": 1180
},
"name": "THE NEW",
"sectionName": "WOMAN"
}
]
}
]
},
"status": "success"
}
}About the Zara API
Product Catalog and Search
get_categories returns the complete Zara US category tree — top-level sections (WOMAN, MAN, KIDS) and their nested subcategories, each carrying an id, key, name, sectionName, and SEO metadata. Those subcategory IDs feed directly into get_category_products, which returns a total count plus an array of product summaries: id, name, price (in cents), reference, sectionName, familyName, seo, and availability. Not every category ID yields products; subcategory-level IDs are the reliable ones.
search_products accepts a query string and optional section (WOMAN, MAN, or KIDS), limit, and offset for pagination. It returns a total, an isLastPage boolean, and a products array structured identically to category results. Each product's seo object includes a seoProductId (8-digit code) needed by get_product_details, while the top-level id field (a longer numeric value) is required by get_product_measurements and get_related_products.
Product Details and Sizing
get_product_details takes the 8-digit seoProductId and returns the full product record: name, price, familyName, sectionName, availability, and a detail object that includes a colors array with images, size lists, and per-size availability. get_product_measurements takes the internal numeric id and returns a sizeGuideInfo object with a sizes array containing body measurements per size and a shape guide, plus a nullable measureGuideInfo field with supplementary guidance.
Stores, Availability, and Shipping
get_stores accepts lat and lng coordinates and returns nearby US Zara locations with addressLines, zipCode, openingHours, and a storeServices array. check_store_availability takes a product reference string and a comma-separated list of store_ids, returning a productAvailability array per store. get_related_products returns 'Complete Your Look' recommendations keyed by the internal numeric product ID — the response mirrors the standard product shape with id, name, price, detail, seo, and availability. get_shipping_info requires no inputs and returns structured shipping policy content covering store pickup, home delivery, and delivery point options along with a FAQ section.
The Zara API is a managed, monitored endpoint for zara.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when zara.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official zara.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a Zara price tracker that monitors specific product IDs for price changes using
get_product_details. - Power a size-recommendation tool by pulling per-size body measurements from
get_product_measurements. - Display in-store stock availability for a given product across multiple nearby locations using
get_storesandcheck_store_availability. - Create a category browser or navigation mirror of the Zara US site using
get_categoriesandget_category_products. - Generate 'Complete Your Look' outfit suggestions in a fashion app by calling
get_related_productsfor each viewed item. - Aggregate Zara US product catalog data by section (WOMAN, MAN, KIDS) for trend analysis using
search_productswith thesectionfilter. - Surface Zara shipping options and return policies alongside product listings using
get_shipping_info.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Zara have an official public developer API?+
What does `get_category_products` return and how do I find valid category IDs?+
get_category_products returns a total count and a products array with fields including id, name, price (in cents), reference, sectionName, familyName, seo, and availability. Not all category IDs return products — the subcategories from get_categories are the reliable source of working IDs. Top-level section IDs like WOMAN or MAN typically return empty results.Which product ID format do the different endpoints require?+
get_product_details requires the 8-digit seoProductId found in a product's seo object (e.g. '04745031'). get_product_measurements and get_related_products require the internal numeric id field (e.g. '507953853'), which is a longer integer also returned by search_products and get_product_details.