IKEA
API de categoria da IKEA
Os produtos de uma categoria da IKEA por id ou URL de categoria, com as mesmas ordenações e filtros da pesquisa: número de artigo, nome, tipo, design, preço e preço anterior na moeda do mercado, etiqueta de preço, classificação, variantes e caminho de categorias de cada produto, além da categoria (id, nome, url, categorias superiores), do total e das facetas. Nos 50 mercados da ikea.com e na China (ikea.cn). Custa 1 crédito por pedido.
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/jsoncategory_idstringUm id de categoria: categories[].id do endpoint de categorias, ou um id de category_path / facets de uma pesquisa, por exemplo 10382 = estantes de livros e fu003 = sofás em us. Envie category_id ou url.
Example: 10382
urlstringUma página de categoria da IKEA, como alternativa a category_id.
Example: https://www.ikea.com/us/en/cat/bookcases-10382/
countrystringdefault:usO mercado da IKEA, como código em minúsculas. Este endpoint serve 51 mercados: os 50 mercados da ikea.com e a China (ikea.cn). Nomes, descrições e etiquetas chegam no idioma do mercado e os preços na sua moeda, nunca convertidos; a resposta repete country, language e currency. Um mercado fora desta lista responde 400 antes de ser cobrado qualquer crédito.
Example: pt
us— Estados Unidos, USD, idiomas en, es. Valor por omissão.ca— Canadá, CAD, idiomas en, fr.gb— Reino Unido, GBP, idioma en.ie— Irlanda, EUR, idioma en.de— Alemanha, EUR, idiomas de, en.at— Áustria, EUR, idiomas de, en.ch— Suíça, CHF, idiomas de, fr, it, en.fr— França, EUR, idioma fr.be— Bélgica, EUR, idiomas nl, fr, en.nl— Países Baixos, EUR, idiomas nl, en.dk— Dinamarca, DKK, idioma da.se— Suécia, SEK, idiomas sv, en.no— Noruega, NOK, idiomas no, en.fi— Finlândia, EUR, idiomas fi, sv, en.ee— Estónia, EUR, idiomas et, ru, en.lv— Letónia, EUR, idiomas lv, ru, en.lt— Lituânia, EUR, idiomas lt, ru, en.pl— Polónia, PLN, idioma pl.cz— Chéquia, CZK, idiomas cs, en.sk— Eslováquia, EUR, idioma sk.hu— Hungria, HUF, idioma hu.hr— Croácia, EUR, idioma hr.si— Eslovénia, EUR, idioma sl.rs— Sérvia, RSD, idioma sr.ro— Roménia, RON, idioma ro.pt— Portugal, EUR, idiomas pt, en.es— Espanha, EUR, idiomas es, en, ca, eu, gl.it— Itália, EUR, idioma it.il— Israel, ILS, idioma he.ae— Emirados Árabes Unidos, AED, idiomas ar, en.sa— Arábia Saudita, SAR, idiomas ar, en.kw— Kuwait, KWD, idiomas ar, en.qa— Catar, QAR, idiomas ar, en.bh— Barém, BHD, idiomas ar, en.om— Omã, OMR, idiomas ar, en.jo— Jordânia, JOD, idiomas ar, en.eg— Egito, EGP, idiomas ar, en.ma— Marrocos, MAD, idiomas ar, fr, en.in— Índia, INR, idioma en.my— Malásia, MYR, idiomas ms, en.sg— Singapura, SGD, idioma en.ph— Filipinas, PHP, idioma en.th— Tailândia, THB, idiomas th, en.jp— Japão, JPY, idiomas ja, en.kr— Coreia do Sul, KRW, idiomas ko, en.au— Austrália, AUD, idioma en.nz— Nova Zelândia, NZD, idioma en.mx— México, MXN, idiomas es, en.cl— Chile, CLP, idioma es.co— Colômbia, COP, idioma es.cn— China (ikea.cn), CNY, idiomas zh, en.
languagestringO idioma da resposta, um dos que o site do mercado serve; por omissão, o primeiro (pt em pt, en em us, de em de). Em Portugal: pt ou en. Outros mercados com vários idiomas: us en/es, ca en/fr, de e 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, es es/en/ca/eu/gl, os mercados do Golfo e árabes 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 e es_islands es/en, is en/is. Os restantes têm um só idioma. Outro código responde 400.
Example: pt
pageintegerdefault:1Página de resultados, a partir de 1. A IKEA serve os primeiros 2000 resultados de uma lista mais uma página, por isso (page - 1) x page_size não pode ultrapassar 2000.
Example: 2
page_sizeintegerdefault:24Produtos por página, 1-100.
Example: 48
sortenum<string>default:relevanceOrdem dos resultados.
Example: price_asc
relevance— A ordem do próprio site. Valor por omissão.price_asc— Mais barato primeiro.price_desc— Mais caro primeiro.newest— Novidades primeiro.rating— Mais bem classificados primeiro.name_asc— Nome de A a Z.most_popular— Mais populares primeiro.
colorstring | string[]Id(s) de cor das facetas (parâmetro f-colors), por exemplo 10156 = branco.
Example: 10156
price_bucketstringUm id de intervalo de preço das facetas (parâmetro f-price-buckets), por exemplo PRICE_0_5000 = de 0 a 49,99 na moeda do mercado.
Example: PRICE_0_5000
new_onlybooleanApenas novidades.
Example: true
last_chancebooleanApenas produtos de última oportunidade (a sair de linha).
Example: true
family_pricebooleanApenas produtos com preço de membro IKEA Family.
Example: true
top_sellerbooleanApenas os mais vendidos.
Example: true
store_idstring | integerUm id de loja (stores[].store_id do endpoint de lojas). Acrescenta a disponibilidade de cada produto nessa loja (nível de stock, entrega ao domicílio) e ativa availability.
Example: 399
availabilityenum<string>Com store_id: in_store (em stock na loja, por omissão), click_collect ou online.
Example: in_store
in_store— Em stock na loja.click_collect— Disponível para levantar na loja (click & collect).online— Disponível online.
filtersobjectQualquer outra faceta, com a chave de facets[].parameter, por exemplo {"f-materials": ["47350"]}. As facetas booleanas aceitam true.
Example: {"f-materials": ["47350"]}
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# Tire um id da árvore da IKEA Portugal e liste essa categoria, do mais barato ao mais caro.
tree = client.ikea.categories(country="pt")["data"]["categories"]
cat_id = tree[0]["id"]
r = client.ikea.category(category_id=cat_id, country="pt", sort="price_asc", page_size=48)["data"]
print(r["category"]["name"], r["total"])
for i in r["items"]:
print(i["item_no"], i["name"], i["type_name"], i["price"])Response