IKEA
IKEA カテゴリー API
IKEA の1つのカテゴリーの商品を、カテゴリーIDまたはカテゴリーページのURLで取得します。並べ替えと絞り込みは検索と同じです。各商品の商品番号、商品名、種類、デザイン、マーケットの通貨での価格と値下げ前の価格、価格タグ、評価、バリエーション、カテゴリーのパスに加え、カテゴリー(id、name、url、parents)、total、ファセットを返します。ikea.com の50マーケットと中国(ikea.cn)に対応。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/jsoncategory_idstringカテゴリーID:categories エンドポイントの categories[].id、または検索の category_path / ファセットのID。例:fu003 = ソファ、10382 = 本棚(アメリカ)。category_id か url のどちらかを送ります。
Example: fu003
urlstringIKEA のカテゴリーページ(category_id の代わり)。
Example: https://www.ikea.com/jp/ja/cat/sofas-fu003/
countrystringdefault:usIKEA のマーケット(小文字のコード)。このエンドポイントは51のマーケット(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。
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
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 のソファ(fu003)を安い順に、1ページ48件。
r = client.ikea.category(category_id="fu003", country="jp", 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