IKEA
API de promoções da IKEA
Uma das listas de promoções da IKEA do mercado: novos preços mais baixos, preços de membro IKEA Family, última oportunidade (produtos a sair de linha), novidades, a gama de preço mais baixo, os mais vendidos, edições limitadas e ofertas por tempo limitado, só na loja ou de preço reduzido. Cada produto traz o preço e o preço anterior na moeda do mercado, a etiqueta de preço e as datas de validade do preço, com as mesmas ordenações e filtros da pesquisa. 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/jsontypeenum<string>requiredQue lista de promoções.
Example: new_lower_price
new_products— Novidades.family_price— Preços de membro IKEA Family: price é o preço de membro e previous_price o normal.new_lower_price— Novo preço mais baixo ("Preço ainda mais baixo" na IKEA Portugal): previous_price é o preço anterior à descida, com as datas de validade do novo preço.last_chance— Última oportunidade: produtos a sair de linha.lowest_price— A gama de preço mais baixo.top_seller— Os mais vendidos.limited_edition— Edições limitadas.time_restricted— Ofertas por tempo limitado.in_store_price_only— Preços válidos apenas na loja.reduced_price_offer— Ofertas de preço reduzido.
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")
# Preços reduzidos da IKEA Portugal, do mais caro para o mais barato, 100 por página.
r = client.ikea.deals(type="new_lower_price", country="pt", page_size=100, sort="price_desc")["data"]
print(r["total"], "artigos com preço reduzido em", r["currency"])
for i in r["items"][:10]:
print(i["name"], i["type_name"], i["previous_price"], "->", i["price"], i["price_valid_to"])Response