Zara
Zara Store Stock API
Units of one Zara colour in physical Zara stores, per size, on 100 of the 102 Zara storefronts: for each store the units of every size, split into sales floor and stockroom, the total and where in the store the item is (area, floor, section, zone). By up to 8 store ids from the stores endpoint, or by a point (the 8 nearest stores, with their address). This is store stock; online stock is the stock endpoint. Costs 2 credits with store_ids, 4 with lat + lng (1 per Zara call on cn).
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsonproduct_idstringrequiredA Zara product id: the colour's product id (items[].product_id of any answer, the v1 of a product link). Usually the same across markets but not always (cn runs its own ids); match across markets with the reference.
Example: 588478514
store_idsstring[]Up to 8 Zara store ids (stores[].store_id of the stores answer). Send store_ids or lat + lng.
Example: ["3904", "3862"]
latnumberLatitude of a point in the country: the 8 nearest stores are checked (a stores lookup first, 4 credits).
Example: 40.7128
lngnumberLongitude, with lat.
Example: -74.006
countrystringdefault:usThe Zara storefront, as a lowercase country code (gb for the United Kingdom, which Zara files under /uk/). This endpoint serves 100 of the 102 Zara storefronts: not ao, iq (Zara lists no stores there; 400, not charged). Prices come back in the market's own currency, never converted; every answer echoes country, language and currency. by (Zara is not selling online in Belarus), the 115 countries Zara serves only from its worldwide store (the Spain catalogue in euros), any other country without a Zara online store, and uk (send gb) answer 400, not charged.
Example: us
ad— Andorra, EUR, ca (Catalan), en (English), fr (French), es (Spanish); default ca.ae— United Arab Emirates, AED, en (English), ar (Arabic); default en.al— Albania, ALL, sq (Albanian), en (English); default sq.am— Armenia, AMD, ru (Russian), hy (Armenian), en (English); default ru.ar— Argentina, ARS, es (Spanish), en (English); default es.at— Austria, EUR, de (German), en (English); default de.au— Australia, AUD, en (English).aw— Aruba, AWG, en (English), es (Spanish); default en.az— Azerbaijan, AZN, ru (Russian), en (English); default ru.ba— Bosnia and Herzegovina, BAM, hr (Croatian), en (English); default hr.be— Belgium, EUR, en (English), nl (Dutch), fr (French); default en.bg— Bulgaria, EUR, bg (Bulgarian), en (English); default bg.bh— Bahrain, BHD, en (English), ar (Arabic); default en.br— Brazil, BRL, pt (Portuguese), en (English); default pt.ca— Canada, CAD, en (English), fr (French); default en.ch— Switzerland, CHF, en (English), fr (French), de (German), it (Italian); default en.cl— Chile, CLP, es (Spanish), en (English); default es.cn— China (zara.cn), CNY, zh (Simplified Chinese), en (English); default zh. Zara's separate China site, with its own product ids.co— Colombia, COP, es (Spanish), en (English); default es.cr— Costa Rica, CRC, es (Spanish), en (English); default es.cw— Curacao, XCG, en (English).cy— Cyprus, EUR, el (Greek), en (English); default el.cz— Czechia, CZK, cs (Czech), en (English); default cs.de— Germany, EUR, de (German), en (English); default de.dk— Denmark, DKK, da (Danish), en (English); default da.do— Dominican Republic, DOP, es (Spanish), en (English); default es.dz— Algeria, DZD, ar (Arabic), en (English), fr (French); default ar.ec— Ecuador, USD, es (Spanish), en (English); default es.ee— Estonia, EUR, et (Estonian), en (English); default et.eg— Egypt, EGP, ar (Arabic), en (English); default ar.es— Spain, EUR, es (Spanish), en (English), eu (Basque), gl (Galician), ca (Catalan); default es.fi— Finland, EUR, fi (Finnish), sv (Swedish), en (English); default fi.fr— France, EUR, fr (French), en (English); default fr.gb— United Kingdom, GBP, en (English).ge— Georgia, GEL, en (English), ka (Georgian); default en.gr— Greece, EUR, el (Greek), en (English); default el.gt— Guatemala, GTQ, es (Spanish), en (English); default es.hk— Hong Kong, HKD, en (English), zh-Hant (Traditional Chinese); default en.hn— Honduras, HNL, es (Spanish), en (English); default es.hr— Croatia, EUR, hr (Croatian), en (English); default hr.hu— Hungary, HUF, hu (Hungarian), en (English); default hu.ic— Canary Islands, EUR, es (Spanish), en (English); default es.id— Indonesia, IDR, id (Indonesian), en (English); default id.ie— Ireland, EUR, en (English).il— Israel, ILS, he (Hebrew), en (English); default he.in— India, INR, en (English).is— Iceland, ISK, en (English).it— Italy, EUR, it (Italian), en (English); default it.jo— Jordan, JOD, en (English), ar (Arabic); default en.jp— Japan, JPY, ja (Japanese), en (English); default ja.kh— Cambodia, KHR, en (English).kr— South Korea, KRW, ko (Korean), en (English); default ko.kw— Kuwait, KWD, en (English), ar (Arabic); default en.kz— Kazakhstan, KZT, ru (Russian), kk (Kazakh), en (English); default ru.lb— Lebanon, LBP, en (English), ar (Arabic); default en.lt— Lithuania, EUR, lt (Lithuanian), en (English); default lt.lu— Luxembourg, EUR, fr (French), en (English), de (German); default fr.lv— Latvia, EUR, lv (Latvian), en (English); default lv.ma— Morocco, MAD, fr (French), en (English); default fr.mc— Monaco, EUR, fr (French), en (English); default fr.me— Montenegro, EUR, sr (Serbian), en (English); default sr.mk— North Macedonia, MKD, mk (Macedonian), sq (Albanian), en (English); default mk.mo— Macau, MOP, zh-Hant (Traditional Chinese), en (English); default zh-Hant.mt— Malta, EUR, en (English).mx— Mexico, MXN, es (Spanish), en (English); default es.my— Malaysia, MYR, en (English).ni— Nicaragua, NIO, es (Spanish), en (English); default es.nl— Netherlands, EUR, en (English), nl (Dutch); default en.no— Norway, NOK, no (Norwegian), en (English); default no.nz— New Zealand, NZD, en (English).om— Oman, OMR, en (English), ar (Arabic); default en.pa— Panama, PAB, es (Spanish), en (English); default es.pe— Peru, PEN, es (Spanish), en (English); default es.ph— Philippines, PHP, en (English).pl— Poland, PLN, pl (Polish), uk (Ukrainian), en (English); default pl.pr— Puerto Rico, USD, es (Spanish), en (English); default es.pt— Portugal, EUR, pt (Portuguese), en (English); default pt.py— Paraguay, PYG, es (Spanish), en (English); default es.qa— Qatar, QAR, en (English), ar (Arabic); default en.ro— Romania, RON, ro (Romanian), en (English); default ro.rs— Serbia, RSD, sr (Serbian), en (English); default sr.sa— Saudi Arabia, SAR, en (English).se— Sweden, SEK, sv (Swedish), en (English); default sv.sg— Singapore, SGD, en (English).si— Slovenia, EUR, sl (Slovenian), en (English); default sl.sk— Slovakia, EUR, sk (Slovak), en (English); default sk.sv— El Salvador, USD, es (Spanish), en (English); default es.th— Thailand, THB, th (Thai), en (English); default th.tn— Tunisia, TND, fr (French), ar (Arabic), en (English); default fr.tr— Turkey, TRY, tr (Turkish), en (English); default tr.tw— Taiwan, TWD, zh-Hant (Traditional Chinese), en (English); default zh-Hant.ua— Ukraine, UAH, uk (Ukrainian), en (English); default uk.us— United States, USD, en (English), es (Spanish); default en. The default.uy— Uruguay, UYU, es (Spanish), en (English); default es.uz— Uzbekistan, UZS, uz (Uzbek), en (English), ru (Russian); default uz.ve— Venezuela, USD, es (Spanish), en (English); default es.vn— Vietnam, VND, vi (Vietnamese), en (English); default vi.xe— Abu Dhabi, Al Ain and Ras Al Khaimah, AED, en (English).xk— Kosovo, EUR, sq (Albanian), en (English); default sq.za— South Africa, ZAR, en (English).
languagestringThe answer's language, from the market's own list (the first is Zara's default; see the markets table): e.g. us en or es, ca en or fr, ch en, fr, de or it, es es, en, eu, gl or ca, jp ja or en, hk, mo and tw zh-Hant or en. Titles, descriptions, colours and category names come back in it. Arabic on iq, xe, ma and sa and Spanish on cw are not served (Zara's own catalogue in those languages returns most titles in another language): send the market's other language. A language the market does not serve answers 400, not charged.
Example: es
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=120)
# Units per size of one colour in 8 New York stores.
r = client.zara.store_stock(
product_id="553306790",
country="us",
store_ids=["3904", "3862", "3037", "10815", "3074", "11818", "3818", "18957"],
)["data"]
print(r["stores_with_stock"], "stores with units")
for s in r["stores"]:
print(s["store_id"], s["units_total"], [(z["size"], z["units"]) for z in s["sizes"]])Response