Zara
Zara Suggestions API
The search suggestions Zara offers for what a shopper has typed, in the market's language, on 92 of the 102 Zara storefronts: up to 10 suggestion texts, for keyword research and search boxes. Where Zara has no suggestions in the request language and the market serves English, its English suggestions are answered instead, with language_used en and a note. Costs 2 credits per request, 4 when the English fallback runs (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/jsonquerystringrequiredWhat the shopper has typed so far, 1-100 characters.
Example: jea
countrystringdefault:usThe Zara storefront, as a lowercase country code (gb for the United Kingdom, which Zara files under /uk/). This endpoint serves 92 of the 102 Zara storefronts: not ad, al, am, az, ba, dz, mk, mo, uz, xk (Zara's suggestions answer nothing in the market's language there and the English fallback is not verified yet; use search; 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
ae— United Arab Emirates, AED, en (English), ar (Arabic); default en.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.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.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.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.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).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.
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=120)
for country in ["us", "gb", "es", "de"]:
r = client.zara.suggestions(query="jea", country=country)["data"]
print(country, r["language_used"], [s["text"] for s in r["suggestions"]])Response