API de pesquisa da IKEA

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

Palavras-chave, 1-200 caracteres, em qualquer idioma que o mercado sirva. Um número de artigo também funciona.

Example: kallax

O mercado da IKEA, como código em minúsculas. Este endpoint serve 55 mercados: os 50 mercados da ikea.com, a China (ikea.cn), Porto Rico, a República Dominicana, as Canárias e Baleares e a Islândia. 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.
• pr — Porto Rico, USD, idiomas en, es.
• do — República Dominicana, DOP, idiomas es, en.
• es_islands — Canárias e Baleares (envie island), EUR, idiomas es, en.
• is — Islândia, ISK, idiomas en, is.

O 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

Obrigatório com country es_islands (as lojas online das Canárias e Baleares) e não permitido nos restantes casos: a ilha cuja loja é consultada.

Example: tenerife

• tenerife — Tenerife (Canárias).
• grancanaria — Gran Canaria (Canárias).
• lanzarote — Lanzarote (Canárias).
• fuerteventura — Fuerteventura (Canárias).
• lapalma — La Palma (Canárias).
• lagomera — La Gomera (Canárias).
• elhierro — El Hierro (Canárias).
• mallorca — Maiorca (Baleares).
• menorca — Minorca (Baleares).
• ibiza — Ibiza (Baleares).

Limita a id(s) de categoria das facetas (parâmetro f-subcategories), por exemplo st002.

Example: st002

Pá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

Produtos por página, 1-100.

Example: 48

Ordem 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.

Id(s) de cor das facetas (parâmetro f-colors), por exemplo 10156 = branco.

Example: 10156

Um 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

Apenas novidades.

Example: true

Apenas produtos de última oportunidade (a sair de linha).

Example: true

Apenas produtos com preço de membro IKEA Family.

Example: true

Apenas os mais vendidos.

Example: true

Um 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

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.

Qualquer outra faceta, com a chave de facets[].parameter, por exemplo {"f-materials": ["47350"]}. As facetas booleanas aceitam true.

Example: {"f-materials": ["47350"]}