E-commerce & Marketplaces

Rakuten Ichiba API scraper API

The Rakuten Ichiba API returns product data from Japan's largest e-commerce marketplace as clean JSON.

7 actionsLive JSON1,000 free creditsMCP-ready

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

The primary search endpoint returns items with name, price (JPY), shop, points, shipping price, review URL and images, and you can pull an item, reviews, variants, a shop, a ranking and the genre tree. It is built for price intelligence, catalog enrichment and Japanese e-commerce analytics that need Rakuten data without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on Jul 18, 2026, 5:19 PM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/rakuten/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "keyword": "ヘッドホン"
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "rakuten",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 1050.9,
    "record_count": 50,
    "bytes": 1000180,
    "cache_hit": false,
    "method": "embedded_ssr_state",
    "url": "https://search.rakuten.co.jp/search/mall/%E3%83%98%E3%83%83%E3%83%89%E3%83%9B%E3%83%B3/",
    "page": 1,
    "page_size": 45,
    "has_more": true,
    "total": 588939,
    "next_page": 2
  },
  "data": {
    "results": [
      {
        "item_code": "10002315",
        "item_name": "Anker Soundcore Q30i (Bluetooth5.3 ワイヤレス ヘッドホン）【ウルトラノイズキャンセリング/外音取り込みモード/Bluetooth対応/ハイレゾ対応(AUX接続時) / 最大80時間音楽再生 / マイク内蔵/専用アプリ対応】",
        "item_price": 9990,
        "currency": "JPY",
        "item_url": "https://item.rakuten.co.jp/anker/a3028n/",
        "shop_name": "アンカー・ダイレクト楽天市場店",
        "shop_code": "anker",
        "shop_id": 294713,
        "review_average": 4.76,
        "review_count": 41,
        "review_url": "https://review.rakuten.co.jp/item/1/294713_10002315/1.1/",
        "image_urls": [
          "https://thumbnail.image.rakuten.co.jp/@0_mall/anker/cabinet/listing/tmb/a3028n/a3028n_normal_v2.jpg"
        ],
        "availability": "in_stock",
        "genre_id": "502835",
        "genre_path": "/0/211742/100155/502835",
        "subtitle": "最大24ヶ月保証",
        "shipping_price": 0,
        "points": 90,
        "is_sold_out": false,
        "product_url": null
      },
      {
        "item_code": "10000135",
        "item_name": "★7/17AM10：00〜クーポン割！【公式限定】 JBL ワイヤレスヘッドホン TUNE770NC | ジェービーエル 高音質 ノイズキャンセリング ヘッドホン ヘッドフォン オーバーイヤー Bluetooth 5.3 アプリ対応 ブルートゥース 折り畳み マルチポイント接続",
        "item_price": 12980,
        "currency": "JPY",
        "item_url": "https://item.rakuten.co.jp/jblstore/tune-770nc/",
        "shop_name": "JBL・AKG公式ストア",
        "shop_code": "jblstore",
        "shop_id": 398768,
        "review_average": 4.7,
        "review_count": 393,
        "review_url": "https://review.rakuten.co.jp/item/1/398768_10000135/1.1/",
        "image_urls": [
          "https://thumbnail.image.rakuten.co.jp/@0_mall/jblstore/cabinet/event/2607m2_thumb/th_tune770_2607m2.jpg"
        ],
        "availability": "in_stock",
        "genre_id": "502835",
        "genre_path": "/0/211742/100155/502835",
        "subtitle": "「 詩羽 ヘッドホン 」JBL PURE BASSサウンドを再現する40mmドライバー搭載 JBL ヘッドホン ヘッドフォン ワイヤレス bluetooth 有線 ワイヤレス",
        "shipping_price": 0,
        "points": 118,
        "is_sold_out": false,
        "product_url": null
      },
      {
        "item_code": "10000021",
        "item_name": "EDIFIER W820NB PLUS Gen2 ワイヤレスヘッドホン Bluetooth 6.1 ノイズキャンセリング Hi-Res LDAC対応 最大88時間再生 マルチポイント接続 折りたたみ式 マイク付き 無線 軽量 オーバーイヤー ヘッドフォン PC スマホ iPhone Android テレビ かわいい",
        "item_price": 8980,
        "currency": "JPY",
        "item_url": "https://item.rakuten.co.jp/edifier-2022/w820nbplus/",
        "shop_name": "EDIFIER楽天市場店",
        "shop_code": "edifier-2022",
        "shop_id": 415727,
        "review_average": 4.59,
        "review_count": 997,
        "review_url": "https://review.rakuten.co.jp/item/1/415727_10000021/1.1/",
        "image_urls": [
          "https://thumbnail.image.rakuten.co.jp/@0_mall/edifier-2022/cabinet/09887945/12271860/imgrc[redacted-phone].jpg"
        ],
        "availability": "in_stock",
        "genre_id": "502835",
        "genre_path": "/0/211742/100155/502835",
        "subtitle": "ノイズキャンセリング・マルチポイント接続・ハイレゾ・LDAC対応・外音取り込み・風切り音低減・折り畳み可能・通話ノイキャン・USB-C急速充電・低遅延ゲームモード・専用アプリ",
        "shipping_price": 0,
        "points": 81,
        "is_sold_out": false,
        "product_url": null
      }
    ],
    "keyword": "ヘッドホン",
    "genre_id": null,
    "page": 1,
    "page_size": 45,
    "has_more": true,
    "total": 588939,
    "next_page": 2
  }
}

Actions

What the Rakuten Ichiba API scraper API does

Action	Description	Concrete use case	Key params
search	Search Rakuten Ichiba by keyword or genre with sort and price filters — returns items with name, price (JPY), shop, points, shipping, rating and images. Paginated.	Pricing teams call search to search Rakuten Ichiba by keyword or genre with sort and price filters.	keyword, q, genre_id, page, sort, ...
item	Get a Rakuten Ichiba product's detail — title, price (JPY), brand, shop, rating, images, category breadcrumbs, spec attributes, shipping and points.	Marketplace operators call item to get a Rakuten Ichiba product's detail.	url, item_url, shop_code, item_path, manage_number
reviews	Get ALL buyer reviews for a Rakuten Ichiba item, paginated (30/page) — rating, body, reviewer nickname, post date and helpful count, plus the total review count.	Catalog enrichment teams call reviews to get ALL buyer reviews for a Rakuten Ichiba item, paginated (30/page).	url, item_url, shop_code, item_path, manage_number, ...
variants	Get a Rakuten Ichiba item's SKU variant matrix — every color/size/option combination with its price and images.	Retail analysts call variants to get a Rakuten Ichiba item's SKU variant matrix.	url, item_url, shop_code, item_path, manage_number
shop	List a Rakuten Ichiba shop's catalog by shop_code — every item the shop sells, paginated.	Pricing teams call shop to list a Rakuten Ichiba shop's catalog by shop_code.	shop_code, sid, page
ranking	Get the Rakuten Ichiba best-seller ranking — overall or for a genre, by day/week/realtime/month.	Marketplace operators call ranking to get the Rakuten Ichiba best-seller ranking.	genre_id, period, page
genres	Browse the Rakuten Ichiba category (genre) tree — top-level categories, or pass genre_id for a subtree.	Catalog enrichment teams call genres to get browse the Rakuten Ichiba category (genre) tree.	genre_id

Code samples

Call search from your stack

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

import requests

r = requests.post(
    "https://api.reefapi.com/rakuten/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "keyword": "ヘッドホン"
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/rakuten/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "keyword": "ヘッドホン"
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.rakuten.search with {"keyword":"ヘッドホン"}.

Use cases

Who uses this API and why

Pricing teams call search and ranking to track Rakuten prices and best-sellers by genre.
Catalog-enrichment tools use item and variants to fill listings with images and options.
Market analysts use genres and shop to map supply and top sellers in the Japanese market.

FAQ

Questions developers ask before integrating

What is the Rakuten Ichiba API scraper API?

Rakuten Ichiba API scraper API is a ReefAPI endpoint group for rakuten ichiba api scraper It returns live JSON through POST requests under /rakuten/v1.

Is the Rakuten Ichiba API scraper API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Rakuten Ichiba API scraper calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Rakuten Ichiba API scraper login or account?

No login to Rakuten Ichiba API scraper is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Rakuten Ichiba API scraper data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Rakuten Ichiba API scraper API use?

Rakuten Ichiba API scraper actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.

Can I call Rakuten Ichiba API scraper from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call rakuten actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Rakuten Ichiba API scraper API a Rakuten Ichiba API scraper scraper?

It is the managed alternative to a DIY Rakuten Ichiba API scraper scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same rakuten ichiba api scraper back as clean JSON.

Why does my Rakuten Ichiba API scraper scraper keep getting blocked?

Most Rakuten Ichiba API scraper scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.

docs / rakuten

Rakuten Ichiba API scraper

base /rakuten/v17 endpoints

post/rakuten/v1/search1 credit

Search Rakuten Ichiba by keyword or genre with sort and price filters — returns items with name, price (JPY), shop, points, shipping, rating and images. Paginated.

Parameter		Allowed / range	Description
keyword	optional	—	Search keyword (Japanese or English). Provide keyword OR genre_id.
genre_id	optional	—	Rakuten genre id to browse (discover ids 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.
min_price	optional	—	Minimum price filter (JPY).
max_price	optional	—	Maximum price filter (JPY).

Try in playground →

post/rakuten/v1/item1 credit

Get a Rakuten Ichiba product's detail — title, price (JPY), brand, shop, rating, images, category breadcrumbs, spec attributes, shipping and points.

Parameter		Allowed / range	Description
url	optional	—	Full Rakuten item URL (the simplest input). Alternative: 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/reviews1 credit

Get ALL buyer reviews for a Rakuten Ichiba item, paginated (30/page) — rating, body, reviewer nickname, post date and helpful count, plus the total review count.

Parameter		Allowed / range	Description
url	optional	—	Full Rakuten item URL (the simplest input). Alternative: 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

Get a Rakuten Ichiba item's SKU variant matrix — every color/size/option combination with its price and images.

Parameter		Allowed / range	Description
url	optional	—	Full Rakuten item URL (the simplest input). Alternative: 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

List a Rakuten Ichiba shop's catalog by shop_code — every item the shop sells, paginated.

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

Try in playground →

post/rakuten/v1/ranking1 credit

Get the Rakuten Ichiba best-seller ranking — overall or for a genre, by day/week/realtime/month.

Parameter		Allowed / range	Description
genre_id	optional	—	Genre id to rank within ('0' = overall, the 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

Browse the Rakuten Ichiba category (genre) tree — top-level 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 →

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":"ヘッドホン"}'

Response shape

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