IKEA
IKEA 상품 상세 API
IKEA 상품 하나를 상품 번호 또는 상품 페이지 URL로 조회합니다. 55개 마켓을 지원하며 상품명, 유형, 설명, 가격과 인하 전 가격(적용 기간 포함), IKEA Family 가격, 통화, 색상, 소재, 카테고리, 치수, 이미지, 평점, 평점 수, 항목별 평점, 상세 치수, 소재 구성, 관리 방법, 알아두면 좋은 정보, 안전 주의사항, 포장(포장 수와 각 포장의 크기·무게), 조립 설명서와 사용 설명서 PDF 링크, 디자이너, 색상·사이즈 옵션과 그 가격, 최신 리뷰 3개, 반품 정책을 반환합니다. 상품 조회는 최대 약 100초가 걸릴 수 있습니다. 요청당 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/jsonitem_nostring | integerIKEA 상품 번호: 8자리, 점 구분도 가능(203.518.84). item_no와 url 중 하나를 보냅니다.
Example: 20351884
urlstring지원 마켓의 IKEA 상품 페이지(item_no 대신). 마켓과 언어는 URL에서 읽습니다.
Example: https://www.ikea.com/kr/ko/p/kallax-shelving-unit-white-20351884/
countrystringdefault:usIKEA 마켓(소문자 코드). 이 엔드포인트는 55개 마켓(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.pr— 푸에르토리코, USD, 언어 en, es.do— 도미니카공화국, DOP, 언어 es, en.es_islands— 카나리아 제도·발레아레스 제도(island 지정), EUR, 언어 es, en.is— 아이슬란드, ISK, 언어 en, is.
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
islandenum<string>country가 es_islands(스페인 카나리아 제도·발레아레스 제도 스토어)일 때만 필수이며, 그 외에는 사용할 수 없습니다. 어느 섬의 스토어인지 지정합니다.
Example: tenerife
tenerife— 테네리페(카나리아 제도).grancanaria— 그란카나리아(카나리아 제도).lanzarote— 란사로테(카나리아 제도).fuerteventura— 푸에르테벤투라(카나리아 제도).lapalma— 라팔마(카나리아 제도).lagomera— 라고메라(카나리아 제도).elhierro— 엘이에로(카나리아 제도).mallorca— 마요르카(발레아레스 제도).menorca— 메노르카(발레아레스 제도).ibiza— 이비사(발레아레스 제도).
Request
from scavio import ScavioClient
# 상품 조회는 최대 약 100초가 걸릴 수 있으므로 타임아웃은 120초로.
client = ScavioClient(api_key="sk_live_your_key", timeout=120)
# KALLAX 칼락스 선반유닛 화이트(한국 상품 번호 20351884)
p = client.ikea.product(item_no="20351884", country="kr")["data"]
print(p["full_name"], p["price"], p["currency"], p["rating"], p["rating_count"])
print(p["packaging"]["number_of_packages"], "개 포장", p["packaging"]["max_weight"])
for doc in p["assembly_pdfs"]:
print(doc["label"], doc["url"])Response