IKEA
IKEA Search Suggestions API
What the IKEA search box suggests for what a user typed: each suggestion's text, type (completion, category, product, planner or content), label, url, category_id and item_no when the site gives them, and an image for categories and products. Use it for keyword research or to autocomplete an IKEA search in your own app. On the 50 ikea.com markets and China (ikea.cn). Costs 1 credit per request.
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 user has typed so far, 1-100 characters.
Example: sof
countrystringdefault:usThe IKEA market, as a lowercase code. This endpoint serves 51 markets: the 50 ikea.com markets and China (ikea.cn). Names, descriptions and labels come back in the market's language and prices in its currency, never converted; the answer echoes country, language and currency. A market outside this list answers 400 before anything is charged.
Example: us
us— United States, USD, languages en, es. The default.ca— Canada, CAD, languages en, fr.gb— United Kingdom, GBP, language en.ie— Ireland, EUR, language en.de— Germany, EUR, languages de, en.at— Austria, EUR, languages de, en.ch— Switzerland, CHF, languages de, fr, it, en.fr— France, EUR, language fr.be— Belgium, EUR, languages nl, fr, en.nl— Netherlands, EUR, languages nl, en.dk— Denmark, DKK, language da.se— Sweden, SEK, languages sv, en.no— Norway, NOK, languages no, en.fi— Finland, EUR, languages fi, sv, en.ee— Estonia, EUR, languages et, ru, en.lv— Latvia, EUR, languages lv, ru, en.lt— Lithuania, EUR, languages lt, ru, en.pl— Poland, PLN, language pl.cz— Czech Republic, CZK, languages cs, en.sk— Slovakia, EUR, language sk.hu— Hungary, HUF, language hu.hr— Croatia, EUR, language hr.si— Slovenia, EUR, language sl.rs— Serbia, RSD, language sr.ro— Romania, RON, language ro.pt— Portugal, EUR, languages pt, en.es— Spain, EUR, languages es, en, ca, eu, gl.it— Italy, EUR, language it.il— Israel, ILS, language he.ae— United Arab Emirates, AED, languages ar, en.sa— Saudi Arabia, SAR, languages ar, en.kw— Kuwait, KWD, languages ar, en.qa— Qatar, QAR, languages ar, en.bh— Bahrain, BHD, languages ar, en.om— Oman, OMR, languages ar, en.jo— Jordan, JOD, languages ar, en.eg— Egypt, EGP, languages ar, en.ma— Morocco, MAD, languages ar, fr, en.in— India, INR, language en.my— Malaysia, MYR, languages ms, en.sg— Singapore, SGD, language en.ph— Philippines, PHP, language en.th— Thailand, THB, languages th, en.jp— Japan, JPY, languages ja, en.kr— South Korea, KRW, languages ko, en.au— Australia, AUD, language en.nz— New Zealand, NZD, language en.mx— Mexico, MXN, languages es, en.cl— Chile, CLP, language es.co— Colombia, COP, language es.cn— China (ikea.cn), CNY, languages zh, en.
languagestringThe answer's language, one the market's site serves; the default is the market's first (en on us, de on de, fr on fr). Multi-language markets: us en/es, ca en/fr, de and at de/en, ch de/fr/it/en, be nl/fr/en, nl nl/en, se sv/en, no no/en, fi fi/sv/en, ee et/ru/en, lv lv/ru/en, lt lt/ru/en, cz cs/en, pt pt/en, es es/en/ca/eu/gl, the Gulf and Arab markets ar/en (ma ar/fr/en), my ms/en, th th/en, jp ja/en, kr ko/en, mx es/en, cn zh/en, pr en/es, do and es_islands es/en, is en/is. Every other market has one language. Another code answers 400.
Example: fr
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
r = client.ikea.suggestions(query="sof", country="us")["data"]
for s in r["suggestions"]:
print(s["type"], s["text"], s["category_id"])Response