docs / rakuten

Rakuten Ichiba Product API

base /rakuten/v17 endpoints

post/rakuten/v1/search1 credit

keyword or genre product search (name/price/shop/reviews/images), paginated

Parameter		Allowed / range	Description
keyword	optional	—	Search keyword. (search needs keyword OR genre_id.)
genre_id	optional	—	Rakuten genre id to browse (discover via the genres action).
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.
sort = standard	optional	standard · price_asc · price_desc · review · new	Result ordering (raw Rakuten 's' codes also accepted).
min_price	optional	—	Minimum price (JPY).
max_price	optional	—	Maximum price (JPY).

Try in playground →

post/rakuten/v1/item1 credit

product detail page (title/price/shop/reviews/images/genre)

Parameter		Allowed / range	Description
url	optional	—	Full Rakuten item URL. (item needs url OR shop_code + item_path.)
shop_code	optional	—	Rakuten shop code (pair with item_path as an alternative to url).
item_path	optional	—	Item path within the shop (pair with shop_code).

Try in playground →

post/rakuten/v1/shop1 credit

shop catalog listing by shop_code (paginated)

Parameter		Allowed / range	Description
shop_code	required	—	Rakuten shop code (urlCode).
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.

Try in playground →

post/rakuten/v1/ranking1 credit

genre or overall Ichiba ranking cards (paginated)

Parameter		Allowed / range	Description
genre_id	optional	—	Genre id to rank within ('0' = overall, default).
period = daily	optional	daily · weekly · realtime · monthly	Ranking time window.
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.

Try in playground →

post/rakuten/v1/genres1 credit

Rakuten Ichiba category (genre) tree — browse all categories, or pass genre_id for a subtree.

Parameter		Allowed / range	Description
genre_id	optional	—	Genre id to read the subtree of (omit for the top-level tree).

Try in playground →

post/rakuten/v1/reviews1 credit

Buyer reviews and rating summary for a Rakuten Ichiba item — reviewer, rating, title and body.

Parameter		Allowed / range	Description
url	optional	—	Full Rakuten item URL. (item needs url OR shop_code + item_path.)
shop_code	optional	—	Rakuten shop code (pair with item_path as an alternative to url).
item_path	optional	—	Item path within the shop (pair with shop_code).
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.

Try in playground →

post/rakuten/v1/variants1 credit

SKU variant matrix (color/storage/price/images) from item bootstrap

Parameter		Allowed / range	Description
url	optional	—	Full Rakuten item URL. (item needs url OR shop_code + item_path.)
shop_code	optional	—	Rakuten shop code (pair with item_path as an alternative to url).
item_path	optional	—	Item path within the shop (pair with shop_code).

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/rakuten/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"keyword":"phone"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}