Service

Rakuten Ichiba

Japan, CommerceAvailable

Try in Playground Open the API reference

Overview

Use official Rakuten Web Service APIs to search items, browse genres and attributes, retrieve rankings, and compare product price data.

Status

Operational

99.85%30-day uptimeAvg response390ms

Setup

Auth mode: Managed key
Credentials: A managed key scoped to rakuten-ichiba
Sandbox: Not available

APIs

Selecting a row opens the reference for that API.

Method	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

Issue a sandbox key and make your first reservation.
APIFuse holds the partner credentials. You hold one managed key.
Receive events such as reservation confirmations and delivery updates.
Service outages and gateway errors normalise into one error model.