Service

라쿠텐 이치바

일본, 커머스제공 중

Playground에서 시험 API 레퍼런스 열기

Overview

공식 Rakuten Web Service API로 상품 검색, 장르와 속성 탐색, 랭킹 조회, 상품 가격 비교를 수행합니다.

Status

정상

99.84%30일 가동률평균 응답395ms

Setup

Auth mode: Managed key
Credentials: rakuten-ichiba scope가 허용된 managed key
Sandbox: 미제공

APIs

행을 선택하면 해당 API의 레퍼런스로 이동합니다.

Method	API	Path	Summary
POST		/v1/rakuten-ichiba/get-rankings	Retrieve Rakuten Ichiba item rankings and return normalized ranked item rows. Use when the user asks for trending or top-ranked items overall, within a genre, or by customer demographic. Two modes: genre_id >= 1 for genre rankings (sex and age are not allowed), or genre_id 0/omitted for overall rankings with optional sex and age filters. Do NOT use for keyword search — use rakuten-ichiba:search-items instead. Returns rankings and summary.
POST		/v1/rakuten-ichiba/search-attributes	List informational Rakuten Ichiba attribute metadata for a genre (genre_id >= 1) to understand its catalog structure. Use when the user wants to see which attributes a genre defines. Do NOT use to filter item searches — search-items does not currently accept attribute_id filters; use rakuten-ichiba:search-items with query or genre_id instead. Do NOT use to browse child genres — use rakuten-ichiba:search-genres instead. Returns attributes.
POST		/v1/rakuten-ichiba/search-genres	List the child genres directly under a Rakuten Ichiba genre code, with hierarchy paths and searchable labels. Use when the user wants to browse the genre tree from the root (genre_id 0) or from a known genre. Do NOT use to find a genre from a keyword — use rakuten-ichiba:search-items instead (every returned item carries its genre_id). Do NOT use for attribute metadata — use rakuten-ichiba:search-attributes instead. Returns genres.
POST		/v1/rakuten-ichiba/search-items	Search Rakuten Ichiba item listings by keyword, genre, shop, or item code and return normalized item, price, shop, image, review, and pagination fields. Use when the user wants individual shop listings, item codes, prices, or availability. Do NOT use for product-level price ranges across shops — use rakuten-ichiba:search-products instead. Do NOT use for item rankings — use rakuten-ichiba:get-rankings instead. Every returned item carries its genre_id, so a keyword search is also the fastest way to find a genre instead of walking rakuten-ichiba:search-genres from the root. Returns items and summary.

Related guides

sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.