IKEA
IKEA 카테고리 API
IKEA 카테고리 하나의 상품을 카테고리 ID 또는 카테고리 페이지 URL로 조회합니다. 정렬과 필터는 검색과 같습니다. 각 상품의 상품 번호, 상품명, 유형, 디자인, 마켓 통화 기준의 가격과 인하 전 가격, 가격 태그, 평점, 옵션, 카테고리 경로와 함께 카테고리(id, name, url, parents), total, facet을 반환합니다. ikea.com 50개 마켓과 중국(ikea.cn)을 지원합니다. 요청당 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 / facet ID. 예: 11465 = 오픈수납장/선반유닛(한국), 10382 = bookcases(미국). category_id와 url 중 하나를 보냅니다.
Example: 11465
urlstringIKEA 카테고리 페이지(category_id 대신).
Example: https://www.ikea.com/us/en/cat/bookcases-10382/
countrystringdefault:usIKEA 마켓(소문자 코드). 이 엔드포인트는 51개 마켓(ikea.com 50개 마켓과 중국 ikea.cn)을 지원합니다. 기본값이 us이므로 한국 IKEA에는 반드시 "country": "kr"을 보내세요. 상품명, 설명, 라벨은 해당 마켓의 언어로, 가격은 해당 마켓의 통화로 반환되며 환산하지 않습니다. 응답에는 country, language, currency가 포함됩니다. 지원하지 않는 마켓은 과금 전에 400을 반환합니다.
Example: kr
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응답 언어. 해당 마켓의 사이트가 제공하는 언어 중에서 고릅니다. 기본값은 마켓의 첫 번째 언어입니다(kr은 ko, us는 en, de는 de). 다국어 마켓: kr ko/en, jp ja/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. 그 밖의 마켓은 언어가 하나입니다. 다른 코드는 400을 반환합니다.
Example: en
pageintegerdefault:1결과 페이지(1부터). IKEA는 목록의 처음 2,000개와 한 페이지까지만 제공하므로 (page - 1) x page_size는 2,000을 넘을 수 없습니다.
Example: 2
page_sizeintegerdefault:24페이지당 상품 수(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[]facets의 색상 ID(parameter f-colors). 예: 10156 = 화이트.
Example: 10156
price_bucketstringfacets의 가격대 ID(parameter f-price-buckets). 예: 미국의 PRICE_0_5000 = 0-49.99달러, 한국의 PRICE_5000000_10000000 = ₩50,000-99,999(ID는 마켓마다 facets에서 가져옵니다).
Example: PRICE_5000000_10000000
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: 399
availabilityenum<string>store_id와 함께: in_store(해당 매장 재고 있음, 기본값), click_collect, online.
Example: in_store
in_store— 매장에 재고 있음.click_collect— 해당 매장에서 클릭 앤 콜렉트 가능.online— 온라인 구매 가능.
filtersobject그 밖의 facet을 facets[].parameter를 키로 지정합니다. 예: {"f-materials": ["47350"]}. 불리언 facet에는 true를 넣습니다.
Example: {"f-materials": ["47350"]}
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# 한국 IKEA의 오픈수납장/선반유닛(11465)을 낮은 가격순으로, 페이지당 48개.
r = client.ikea.category(category_id="11465", country="kr", 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