IKEA

IKEA Product API

One IKEA product by article number or product URL on any of 55 markets: name, type, description, price and previous price with their valid dates, IKEA Family price, currency, color, material, category, dimensions, images, rating, rating count and secondary ratings, measurements, materials, care, good to know, safety notes, packaging (number of packages, each package's size and weight), assembly instructions and manuals as PDF links, designer, color and size variants with their prices, the 3 newest reviews and the return policy. A product call can take up to about 100 seconds. Costs 1 credit per request.

POST/api/v1/ikea/product

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

item_nostring | integer

An IKEA article number: 8 digits, dots allowed (205.220.46). Send item_no or url.

Example: 20522046

urlstring

An IKEA product page of a served market, as an alternative to item_no; the market and language are read from it.

Example: https://www.ikea.com/de/de/p/kallax-regal-weiss-80275887/

countrystringdefault:us

The IKEA market, as a lowercase code. This endpoint serves 55 markets: the 50 ikea.com markets, China (ikea.cn), Puerto Rico, the Dominican Republic, the Canary and Balearic islands and Iceland. 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.
pr — Puerto Rico, USD, languages en, es.
do — Dominican Republic, DOP, languages es, en.
es_islands — Canary and Balearic islands (send island), EUR, languages es, en.
is — Iceland, ISK, languages en, is.

languagestring

The 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

islandenum<string>

Required with country es_islands (the Canary and Balearic islands storefronts), not allowed otherwise: which island's storefront.

Example: tenerife

tenerife — Tenerife (Canary Islands).
grancanaria — Gran Canaria (Canary Islands).
lanzarote — Lanzarote (Canary Islands).
fuerteventura — Fuerteventura (Canary Islands).
lapalma — La Palma (Canary Islands).
lagomera — La Gomera (Canary Islands).
elhierro — El Hierro (Canary Islands).
mallorca — Mallorca (Balearic Islands).
menorca — Menorca (Balearic Islands).
ibiza — Ibiza (Balearic Islands).

Request

from scavio import ScavioClient

# A product call can take up to about 100 seconds: allow 120.
client = ScavioClient(api_key="sk_live_your_key", timeout=120)

p = client.ikea.product(item_no="20522046", country="us")["data"]
print(p["full_name"], p["price"], p["currency"], p["rating"], p["rating_count"])
print(p["packaging"]["number_of_packages"], "package(s)")
for doc in p["assembly_pdfs"]:
    print(doc["label"], doc["url"])

Response

"item_no": "20522046",

"article_number": "205.220.46",

"name": "BILLY",

"full_name": "BILLY Bookcase - white 31 1/2x11x79 1/2 "",

"type_name": "Bookcase",

"description": "BILLY bookcase is a beloved icon that never goes out of style. Thanks to its versatility you can use it in many different ways at home – regardless of whether you store books or everyday items in it.",

"url": "https://www.ikea.com/us/en/p/billy-bookcase-white-20522046/",

"price": 79,

"previous_price": null,

"price_valid_from": null,

"price_valid_to": null,

"family_price": null,

"currency": "USD",

"color": "white",

"material": "Wood (including board)",

"category": "Bookshelves & bookcases",

"rating": 4.5,

"rating_count": 2126,

"availability_online": "in_stock",

"summary": "Bookcase, white",

"measure_text": "31 1/2x11x79 1/2 "",

"price_tag": "lower_price_in_store",

"price_note": null,

"lower_price_in_store": true,

"online_sellable": true,

"other_documents": [],

"designer": "Gillis Lundgren",

"return_policy_days": 365,

"detail_level": "full",

"country": "us",

"language": "en"

"response_time": 5660

}

from scavio import ScavioClient # A product call can take up to about 100 seconds: allow 120. client = ScavioClient(api_key="sk_live_your_key", timeout=120) p = client.ikea.product(item_no="20522046", country="us")["data"] print(p["full_name"], p["price"], p["currency"], p["rating"], p["rating_count"]) print(p["packaging"]["number_of_packages"], "package(s)") for doc in p["assembly_pdfs"]: print(doc["label"], doc["url"])