Zara Home APIzarahome.com ↗
Access Zara Home US product data via API: search by keyword, browse categories, and fetch full product details including materials, colors, sizes, and pricing.
What is the Zara Home API?
The Zara Home API provides 4 endpoints covering the full Zara Home US product catalog, from top-level navigation categories down to individual product records. Use search_products to run keyword queries against the entire catalog, or get_category_products to pull listings by category ID. Each product record exposes up to 8 fields including composition, care instructions, color variants with hex values, and size availability.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/fa512633-3ede-4851-abc9-3c50e6069706/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 zarahome-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 Home SDK — browse categories, search products, drill into details."""
from parse_apis.zara_home_product_api import ZaraHome, CategoryId, ProductNotFound
client = ZaraHome()
# List all store categories
for cat in client.categories.list(limit=5):
print(cat.name, cat.id)
# Browse products in the Bedroom category using the enum
bedroom = client.category(id=CategoryId.BEDROOM)
for product in bedroom.products(limit=3):
print(product.name, product.composition)
# Search for products by keyword, take the first result
product = client.products.search(query="cotton", limit=1).first()
if product:
print(product.name, product.description[:80])
# Inspect color variants and sizing
for color in product.colors:
print(color.name, color.hex)
for size in color.sizes:
print(size.description, size.price)
# Typed error handling on a point-lookup
try:
detail = client.products.get(id="479911914")
print(detail.name, detail.care)
except ProductNotFound as exc:
print(f"Product not found: {exc.product_id}")
print("exercised: categories.list / category.products / products.search / products.get")
Returns the top-level navigation categories for the Zara Home US store. The list is static and includes broad sections like Bedroom, Living Room, Kitchen, and Sale. Each category carries an ID usable with get_category_products.
No input parameters required.
{
"type": "object",
"fields": {
"categories": "array of category objects with id, name, and url"
},
"sample": {
"data": {
"categories": [
{
"id": "1020319721",
"url": "/us/new-in-n942",
"name": "New In"
},
{
"id": "1020611313",
"url": "/us/bedroom-bedding-n945",
"name": "Bedroom"
},
{
"id": "1020264592",
"url": "/us/living-room-cushions-blankets-n1004",
"name": "Living Room"
},
{
"id": "1020495068",
"url": "/us/kitchen-n1030",
"name": "Kitchen"
},
{
"id": "1020319730",
"url": "/us/promo-n4359",
"name": "Sale"
}
]
},
"status": "success"
}
}About the Zara Home API
Endpoints and Data Coverage
The API is organized around four endpoints. get_categories returns the top-level navigation structure for the Zara Home US store — categories like Bedroom, Kitchen, and Sale — each with an id, name, and url. Those category IDs feed directly into get_category_products, which returns full product records for every item in that section. search_products accepts a query string (e.g. 'duvet', 'cotton', 'candle') and supports limit and offset parameters for pagination, along with a total_results integer and an is_last_page boolean to help you walk through large result sets.
Product Detail Fields
get_product_details fetches a single product by its numeric product_id and optionally a category_id for richer data. The response includes name, name_en, an HTML description, a composition string (e.g. material percentages), a care array of instruction strings, and a colors array. Each color object carries an id, name, hex value, a sizes list, and associated images. A related_products array lists adjacent items with their id and name.
Pagination and Response Time
Both search_products and get_category_products support limit and offset for pagination. Because full product detail is resolved per item, response time scales linearly with the limit value — keep batch sizes moderate when fetching large sets. Some fields like care and composition may be empty for certain products depending on how the item is catalogued on the site.
Regional Scope
All endpoints target the Zara Home US store. Prices, product availability, and category structure reflect the US catalog. Products not listed in the US store will not appear in search or category results.
The Zara Home API is a managed, monitored endpoint for zarahome.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when zarahome.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 zarahome.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 product comparison tool using
compositionandcolorsfields fromget_product_details - Populate a home décor shopping aggregator with category-level browsing via
get_category_products - Track price changes on specific SKUs by polling
get_product_detailswith known product IDs - Generate a material-filtered product index (e.g. '100% linen') by searching with textile keywords via
search_products - Build a category sitemap for Zara Home US using the
id,name, andurlfields fromget_categories - Analyze color variant availability across product lines using the
colorsarray with hex codes and size lists - Feed a recommendation engine with
related_productsdata returned on each product detail record
| 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 Home offer an official developer API?+
What does `get_product_details` return for color variants?+
colors array contains one object per available color, each with an id, a display name, a hex color value, a sizes list, and associated images. Note that the colors array may be empty for some products depending on how they are catalogued.Does the API cover Zara Home stores outside the US?+
Is stock or inventory availability returned for products?+
sizes field on color objects, but does not expose a dedicated in-stock boolean or warehouse inventory count. You can fork this API on Parse and revise it to add a richer availability field if that data is exposed for the products you are targeting.How does pagination work in `search_products`?+
offset to skip a number of results and limit to cap the batch size. The response includes total_results (total matching products) and is_last_page (boolean) so you can determine when to stop paginating. Because each result requires a full detail fetch, smaller limit values return faster.