Zara API für den deutschen Shop: Preise, Größen und Bestand als JSON

Zara bietet keinen Datenzugang für Entwickler an. Diese API fragt den Shop zara.com/de so ab, wie ihn Kundinnen und Kunden sehen, und liefert Preis in Euro, reduzierten Preis, Farben, Größen mit Lagerstatus und die Zusammensetzung des Stoffs als JSON. Welcher Länder-Shop gelesen wird, entscheidet allein `market`: Mit `"market": "de"` kommen deutsche Preise, unabhängig davon, von wo die Anfrage gestellt wird. Für Lieferanten, Franchisepartner oder Bestellungen bei Inditex ist sie ausdrücklich nicht gedacht.

Funktionierendes Beispiel

Die API liest den deutschen Shop in seiner englischen Sprachfassung (`locale` en_GB, Adresse zara.com/de/en): Preise und Sortiment sind deutsch, Produktnamen und Beschreibungen englisch. Ein deutsches Suchwort trifft deshalb keine Namen und landet in Zaras semantischer Ersatzsuche — `match.type` meldet SEMANTIC_FALLBACK, 273 Treffer. Mit „wool coat“ war es EXACT bei 111 Treffern. Auch „WOOL BLEND“ im Namen sagt wenig über den Anteil: Die Außenseite des ersten Mantels besteht laut `product_detail` zu 50 % aus Wolle.

curl -X POST https://api.reefapi.com/zara/v1/search \
  -H "x-api-key: IHR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"query": "Wollmantel", "market": "de", "max_results": 20}'

{
  "ok": true,
  "data": {
    "query": "Wollmantel",
    "market": { "code": "de", "store_id": "10705", "locale": "en_GB", "currency": "EUR", "url_base": "https://www.zara.com/de/en" },
    "match": { "type": "SEMANTIC_FALLBACK", "provider": "Embeddings", "universe": "WOMAN" },
    "results": [
      {
        "product_id": "605733464",
        "name": "LONG WOOL BLEND COAT WITH BELT",
        "brand": "zara",
        "display_reference": "2745/319",
        "price": { "amount": 119, "currency": "EUR", "was": null, "discount_pct": null, "on_sale": false },
        "availability": "in_stock",
        "section_name": "WOMAN",
        "family_name": "ABRIGO",
        "color": { "name": "Black", "hex": "#121315", "availability": "in_stock" },
        "url": "https://www.zara.com/de/en/long-wool-blend-coat-with-belt-p02745319.html?v1=605733464"
      },
      ...
    ]
  },
  "meta": {
    "record_count": 20,
    "market": "de",
    "match_type": "SEMANTIC_FALLBACK",
    "pagination": { "page": 1, "page_size": 20, "total_results": 273, "has_more": true },
    "cache_hit": false,
    "mode": "live"
  }
}

Grenzen und ehrliche Hinweise

• Inoffiziell: weder Zara noch Inditex stellen diese Schnittstelle bereit, und es besteht keine Partnerschaft.
• Namen, Beschreibungen und Farbnamen kommen auch für `market` de auf Englisch, weil die API die englische Fassung des Shops liest (en_GB); eine Option für die deutsche Sprachfassung gibt es nicht. Für genaue Treffer englische Suchbegriffe verwenden und `match.type` prüfen: Bei SEMANTIC_FALLBACK hat Zara die Wörter nicht gefunden und ähnliche Artikel geliefert.
• Ohne `market` wird der US-Shop gelesen (Standardwert `us`, Preise in USD). Für Deutschland gehört `"market": "de"` in jede Anfrage.
• `family_name` und `subfamily_name` sind Zaras interne, spanische Bezeichnungen (ABRIGO für Mantel), keine übersetzten Kategorien.
• Die Suche läuft über den Inditex-Index des Shops und kann Artikel von Zara Home und Massimo Dutti enthalten. Der Filter `brand` wirkt erst nach dem Abruf, nicht bei Zara selbst.
• Egal welche Gesamtzahl angezeigt wird: Zara liefert pro Suche höchstens knapp 2.000 Artikel, danach kommen keine Treffer mehr. Weiterblättern über `meta.pagination.has_more` steuern, nicht über die Gesamtzahl.
• Für Österreich und die Schweiz gibt es keinen eigenen `market`; angeboten werden die 19 Länder-Shops, die der Parameter auflistet, darunter de.
• `price` und `product_detail` lesen bei jedem Aufruf neu bei Zara. Einen Preisverlauf speichert die API nicht; den baut man aus täglichen `price`-Abfragen selbst auf.