Zara
Zara Search API
Search one Zara market's catalogue by keyword, in that market's language and currency, on all 102 Zara storefronts (205 market-languages): each item with its product id, reference, title, price, old price and discount on a markdown, online availability and every colour with its own price, up to 96 a page with the exact total, sorted by relevance or price and filtered by section, colour, size and price range. A reference instead of a query answers every colour of that reference in the market. Costs 2 credits per request (1 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/jsonquerystringSearch keywords, 1-200 characters, in any language. Send query or reference.
Example: blazer
referencestringA Zara reference as printed on the product page (display_reference of any answer), e.g. 4591/381; 4591/381/800 names one colour. Instead of query: answers every colour of that reference in the market, with sold_here. Paging, sort and filters do not apply.
Example: 4591/381
countrystringdefault:usThe Zara storefront, as a lowercase country code (gb for the United Kingdom, which Zara files under /uk/). This endpoint serves all 102 Zara storefronts. 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.ao— Angola, EUR, pt (Portuguese), en (English); default pt.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).iq— Iraq, IQD, 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
sectionenum<string>Only one section (default: every section).
Example: woman
woman— Woman.man— Man.kids— Kids.home— Home.
pageintegerdefault:1Results page, 1-based, up to 100.
Example: 2
page_sizeintegerdefault:24Items per page, 1 to 96.
Example: 48
sortenum<string>default:relevanceResult order. For some queries Zara answers in its own order and offers no price sort: then sorts_offered is empty and a note says so. cn takes no sort (400).
Example: price_asc
relevance— Zara's own order. The default.price_asc— Price, low to high.price_desc— Price, high to low.
colorstringColour: one value of the color facet of an earlier answer in the same market (facets[].values[].value, e.g. black).
Example: black
sizestringSize: one value of the size facet of an earlier answer (e.g. 38).
Example: 38
price_minnumberLowest price, in the market's currency.
Example: 50
price_maxnumberHighest price, in the market's currency.
Example: 150
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=120)
# Women's blazers in Spain, cheapest first, with the markdowns flagged.
r = client.zara.search(query="blazer", country="es", section="woman", sort="price_asc")["data"]
print(r["total"], "results in", r["currency"])
for i in r["items"]:
print(i["display_reference"], i["title"], i["price"], i["old_price"], i["availability"])Response