IKEA
IKEA 商品検索 API
IKEA の商品をキーワードで検索します。55のマーケットに対応し、ikea.com の50マーケットと中国(ikea.cn)は完全な一覧を返します。1ページはデフォルト24件(最大100件)で、7種類の並べ替えと、色、価格帯、カテゴリー、新商品、販売終了予定、IKEA Family 価格、人気商品、店舗の在庫状況、任意のファセットでの絞り込みに対応します。各商品には商品番号、商品名、種類、デザイン、マーケットの通貨での価格と値下げ前の価格、価格タグ(新しい低価格、IKEA Family 価格など)、評価、バリエーション、カテゴリーのパスが含まれ、ファセット、もしかして、関連キーワード、コンテンツカードも返ります。フランチャイズのサイト(プエルトリコ、ドミニカ共和国、カナリア諸島・バレアレス諸島、アイスランド)は query と page のみに対応します。1リクエスト1クレジットです。
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/jsonquerystringrequired検索キーワード(1〜200文字)。マーケットが提供するどの言語でも検索でき、商品番号でも検索できます。
Example: kallax
countrystringdefault:usIKEA のマーケット(小文字のコード)。このエンドポイントは55のマーケット(ikea.com の50マーケット、中国の ikea.cn、プエルトリコ、ドミニカ共和国、カナリア諸島・バレアレス諸島、アイスランド)に対応しています。デフォルトは us なので、日本の IKEA には必ず "country": "jp" を送ってください。商品名、説明、ラベルはそのマーケットの言語で、価格はそのマーケットの通貨で返り、換算はしません。レスポンスには country、language、currency が含まれます。対象外のマーケットは課金前に400になります。
Example: jp
us— アメリカ、USD、言語 en, es。デフォルト値。ca— カナダ、CAD、言語 en, fr。gb— イギリス、GBP、言語 en。ie— アイルランド、EUR、言語 en。de— ドイツ、EUR、言語 de, en。at— オーストリア、EUR、言語 de, en。ch— スイス、CHF、言語 de, fr, it, en。fr— フランス、EUR、言語 fr。be— ベルギー、EUR、言語 nl, fr, en。nl— オランダ、EUR、言語 nl, en。dk— デンマーク、DKK、言語 da。se— スウェーデン、SEK、言語 sv, en。no— ノルウェー、NOK、言語 no, en。fi— フィンランド、EUR、言語 fi, sv, en。ee— エストニア、EUR、言語 et, ru, en。lv— ラトビア、EUR、言語 lv, ru, en。lt— リトアニア、EUR、言語 lt, ru, en。pl— ポーランド、PLN、言語 pl。cz— チェコ、CZK、言語 cs, en。sk— スロバキア、EUR、言語 sk。hu— ハンガリー、HUF、言語 hu。hr— クロアチア、EUR、言語 hr。si— スロベニア、EUR、言語 sl。rs— セルビア、RSD、言語 sr。ro— ルーマニア、RON、言語 ro。pt— ポルトガル、EUR、言語 pt, en。es— スペイン、EUR、言語 es, en, ca, eu, gl。it— イタリア、EUR、言語 it。il— イスラエル、ILS、言語 he。ae— アラブ首長国連邦、AED、言語 ar, en。sa— サウジアラビア、SAR、言語 ar, en。kw— クウェート、KWD、言語 ar, en。qa— カタール、QAR、言語 ar, en。bh— バーレーン、BHD、言語 ar, en。om— オマーン、OMR、言語 ar, en。jo— ヨルダン、JOD、言語 ar, en。eg— エジプト、EGP、言語 ar, en。ma— モロッコ、MAD、言語 ar, fr, en。in— インド、INR、言語 en。my— マレーシア、MYR、言語 ms, en。sg— シンガポール、SGD、言語 en。ph— フィリピン、PHP、言語 en。th— タイ、THB、言語 th, en。jp— 日本、JPY、言語 ja, en。kr— 韓国、KRW、言語 ko, en。au— オーストラリア、AUD、言語 en。nz— ニュージーランド、NZD、言語 en。mx— メキシコ、MXN、言語 es, en。cl— チリ、CLP、言語 es。co— コロンビア、COP、言語 es。cn— 中国(ikea.cn)、CNY、言語 zh, en。pr— プエルトリコ、USD、言語 en, es。do— ドミニカ共和国、DOP、言語 es, en。es_islands— カナリア諸島・バレアレス諸島(island を指定)、EUR、言語 es, en。is— アイスランド、ISK、言語 en, is。
languagestringレスポンスの言語。そのマーケットのサイトが提供している言語から選びます。デフォルトはマーケットの最初の言語です(jp は ja、us は en、de は de)。複数言語のマーケット:jp ja/en、kr ko/en、cn zh/en、th th/en、us en/es、ca en/fr、de と 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、湾岸・アラブのマーケット ar/en(ma は ar/fr/en)、my ms/en、mx es/en、pr en/es、do と es_islands es/en、is en/is。ほかのマーケットは1言語のみです。それ以外のコードは400になります。
Example: en
islandenum<string>country が es_islands(スペインのカナリア諸島・バレアレス諸島のストア)のときだけ必須で、それ以外では使えません。どの島のストアかを指定します。
Example: tenerife
tenerife— テネリフェ島(カナリア諸島)。grancanaria— グラン・カナリア島(カナリア諸島)。lanzarote— ランサローテ島(カナリア諸島)。fuerteventura— フエルテベントゥラ島(カナリア諸島)。lapalma— ラ・パルマ島(カナリア諸島)。lagomera— ラ・ゴメラ島(カナリア諸島)。elhierro— エル・イエロ島(カナリア諸島)。mallorca— マヨルカ島(バレアレス諸島)。menorca— メノルカ島(バレアレス諸島)。ibiza— イビサ島(バレアレス諸島)。
category_idstring | string[]ファセットのカテゴリーID(parameter f-subcategories)で絞り込みます。例:st002。
Example: st002
pageintegerdefault:1結果のページ(1から)。IKEA は一覧の先頭2,000件と1ページ分までを返すため、(page - 1) x page_size は2,000を超えられません。
Example: 2
page_sizeintegerdefault:241ページあたりの商品数(1〜100)。
Example: 48
sortenum<string>default:relevance結果の並び順。
Example: price_asc
relevance— サイトの標準の並び順。デフォルト値。price_asc— 価格の安い順。price_desc— 価格の高い順。newest— 新しい商品順。rating— 評価の高い順。name_asc— 名前のA〜Z順。most_popular— 人気順。
colorstring | string[]ファセットの色ID(parameter f-colors)。例:10156 = ホワイト。
Example: 10156
price_bucketstringファセットの価格帯ID(parameter f-price-buckets)。例:アメリカの PRICE_0_5000 = 0〜49.99ドル、日本の PRICE_500000_1000000 = ¥5,000〜9,999(IDはマーケットごとにファセットから取得)。
Example: PRICE_500000_1000000
new_onlyboolean新商品のみ。
Example: true
last_chanceboolean販売終了予定(ラストチャンス)の商品のみ。
Example: true
family_pricebooleanIKEA Family 会員価格のある商品のみ。
Example: true
top_sellerboolean人気商品(ベストセラー)のみ。
Example: true
store_idstring | integer店舗ID(stores エンドポイントの stores[].store_id)。その店舗での各商品の在庫状況(在庫レベル、配送)を追加し、availability を使えるようにします。
Example: 392
availabilityenum<string>store_id と一緒に:in_store(その店舗に在庫あり。デフォルト)、click_collect、online。
Example: in_store
in_store— 店舗に在庫あり。click_collect— その店舗でクリック&コレクトが可能。online— オンラインで購入可能。
filtersobjectそのほかのファセットを facets[].parameter をキーにして指定します。例:{"f-materials": ["47350"]}。真偽値のファセットには true を渡します。
Example: {"f-materials": ["47350"]}
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# 日本の IKEA で KALLAX(カラックス)を安い順に。価格は円で、
# 値下げ中の商品には previous_price が入ります。
r = client.ikea.search(query="kallax", country="jp", sort="price_asc")["data"]
print(r["total"], "件,", r["currency"])
for i in r["items"]:
print(i["item_no"], i["item_no_global"], i["name"], i["type_name"], i["price"], i["previous_price"], i["price_tag"])Response