--- title: "Rakuten API: JSON data, 5 endpoints, 1 credit per call" description: "Rakuten API for Japanese product search, item details, rankings by genre and period, reviews and search suggestions as JSON. 1 credit per call." url: https://perceptlayer.com/apis/rakuten --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / Rakuten 1 credit per call 5 endpoints 21 datapoints # Rakuten API Rakuten API for Japanese product search, item details, rankings by genre and period, reviews and search suggestions as JSON. 1 credit per call. [Get a free API key](https://perceptlayer.com/signup) Run it below Rakuten GET /v1/rakuten/search?query=%E3%83%9E%E3%82%B9%E3%82%AF&min\_price=500&max\_price=2000&sort=review\_count ``` { "success": true, "data": { "items": [ { "id": "386567_10000801", "shop_code": "cicibella-sports", "manage_number": "mskblt20", "shop_id": 386567, "item_id": 10000801, "name": "＼高評価／【先着限定クーポンで最安101円】11/12 23:59迄 マスク 秋用マスク 立体 3Dマスク 立体マスク 不織布マスク バイカラーマスク 血色マスク 小顔マスク 立体 マスク カラーマスク くちばしマスク 99% 20枚 10枚*2 cicibella 防災グッズ 花粉 マスク", "subtitle": "今話題の3Dマスク 99％カットフィルター 顔にフィットで小顔効果 血色マスク 不織布マスク オシャレ 血色カラー", "url": "https://item.rakuten.co.jp/cicibella-sports/mskblt20/", "price": 595, "price_is_from": false, "currency": "JPY", "image": "https://thumbnail.image.rakuten.co.jp/@0_gold/cicibella-sports/top-image/day2/mskblt20_101.jpg?_ex=800x800", "images": [ "https://thumbnail.image.rakuten.co.jp/@0_gold/cicibella-sports/top-image/day2/mskblt20_101.jpg?_ex=800x800" ], "genre_id": 402788, "genre_ids": [ 551169, 208264, 568357 ], "is_sold_out": false, "shop": { "id": 386567, "name": "cicibella sports", "code": "cicibella-sports", "url": "https://www.rakuten.co.jp/cicibella-sports/" }, "rating": { "score": 4.44, "count": 47231 }, "shipping": { "fee": 0, "free": true, "delivery_estimate": "12時までの注文で当日出荷" }, "points": { "count": 5, "base_multiplier": 1 }, "tags": [ { "group": "カラー", "name": "ベージュ" }, { "group": "カラー", "name": "ピンク" }, { "group": "紐タイプ（衛生マスク）", "name": "耳かけ" } ] }, { "id": "319439_10002043", "shop_code": "cicib", "manage_number": "msk50-6", "shop_id": 319439, "item_id": 10002043, "name": "本日限りSALE【クーポンで最安1点95円】11/12 23:59迄 マスク 不織布 立体 3Dマスク 立体マスク 不織布マスク バイカラーマスク 血色マスク 小顔マスク マスク カラーマスク くちばし マスク 冷感マスク 99% 20枚 10枚*2 オシャレ cicibella シシベラ 花粉 マスク", "subtitle": "今話題の3Dマスク 99％カットフィルター 顔にフィットで小顔効果 血色マスク 不織布マスク", "url": "https://item.rakuten.co.jp/cicib/msk50-6/", "price": 1980, "price_is_from": false, "currency": "JPY", "image": "https://thumbnail.image.rakuten.co.jp/@0_gold/cicib/top-image/day2/msk50-6_95.jpg?_ex=800x800", "images": [ "https://thumbnail.image.rakuten.co.jp/@0_gold/cicib/top-image/day2/msk50-6_95.jpg?_ex=800x800" ], "genre_id": 402788, "genre_ids": [ 551169, 208264, 568357 ], "is_sold_out": false, "shop": { "id": 319439, "name": "CICI BELLA", "code": "cicib", "url": "https://www.rakuten.co.jp/cicib/" }, "rating": { "score": 4.45, "count": 35954 }, "shipping": { "fee": 0, "free": true, "delivery_estimate": "12時までの注文で当日出荷" }, "points": { "count": 18, "base_multiplier": 1 }, "rank": 2, "rank_genre_id": 568357, "tags": [ { "group": "カラー", "name": "ベージュ" }, { "group": "カラー", "name": "ピンク" }, { "group": "カラー", "name": "オレンジ" } ] }, { "id": "359958_10043729", "shop_code": "centuryshop", "manage_number": "4573186865306-3", "shop_id": 359958, "item_id": 10043729, "name": "＼クーポンで最安1点398円!!／11/19 09:59迄【 送料無料 個包装 】マスク 洗える ひんやりマスク マスク 夏用 洗えるマスク 冷感マスク 布マスク キッズ 大人 UVカット レディース 血色 立体 カラー こども 接触冷感 立体 子供 大人 小さめ 3d 涼感 おしゃれ 花粉", "subtitle": "冬でも快適に使えるあったか立体マスクです 冬用マスク 防寒 あったか 立体 小顔 洗える 耳が痛くない 乾燥対策 保湿 秋冬 男女兼用", "url": "https://item.rakuten.co.jp/centuryshop/4573186865306-3/", "price": 1000, "price_is_from": false, "currency": "JPY", "image": "https://thumbnail.image.rakuten.co.jp/@0_mall/centuryshop/cabinet/mask/3d/4573186865306.jpg?_ex=800x800", "images": [ "https://thumbnail.image.rakuten.co.jp/@0_mall/centuryshop/cabinet/mask/3d/4573186865306.jpg?_ex=800x800" ], "genre_id": 402788, "genre_ids": [ 551169, 208264, 568357 ], "is_sold_out": false, "shop": { "id": 359958, "name": "CENTURY", "code": "centuryshop", "url": "https://www.rakuten.co.jp/centuryshop/" }, "rating": { "score": 4.5, "count": 25302 }, "shipping": { "fee": 0, "free": true, "delivery_estimate": "■即日〜3日以内に発送予定※休業日を除く" }, "points": { "count": 9, "base_multiplier": 1 }, "tags": [ { "group": "総枚数", "name": "3枚" }, { "group": "機能（衛生マスク）", "name": "花粉対策" }, { "group": "形状（衛生マスク）", "name": "立体型" } ] } ], "pagination": { "page": 1, "page_size": 45, "has_next": true, "max_page": 9, "total_results": 462796 }, "currency": "JPY", "filters": { "query": "マスク", "min_price": 500, "max_price": 2000, "sort": "review_count" }, "subgenres": [ { "id": 551169, "name": "医薬品・コンタクト・介護", "count": 108514 }, { "id": 100939, "name": "美容・コスメ・香水", "count": 61373 }, { "id": 100938, "name": "ダイエット・健康", "count": 9394 } ], "related_keywords": [ "マスク 不織布", "マスク 立体", "マスク 日本製" ] }, "meta": { "endpoint_family": "search", "request_id": "req_e438bb15bc2f4787b3f5e492c0765a22", "credits_charged": 1, "credits_remaining": 1930 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | id string | shop\_code string | manage\_number string | shop\_id integer | item\_id integer | name string | subtitle string | url url | price integer | price\_is\_from boolean | currency string | image url | images string\[\] | genre\_id integer | genre\_ids number\[\] | is\_sold\_out boolean | shop object | rating object | shipping object | points object | tags object\[\] | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 386567\_10000801 | cicibella-sports | mskblt20 | 386567 | 10000801 | ＼高評価／【先着限定クーポンで最安101円】11/12 23:59迄 マスク 秋用マスク 立体 3Dマスク 立体マスク 不織布マスク バイカラーマスク 血色マスク 小顔マスク 立体 マスク カラーマスク くちばしマスク 99% 20枚 10枚\*2 cicibella 防災グッズ 花粉 マスク | 今話題の3Dマスク 99％カットフィルター 顔にフィットで小顔効果 血色マスク 不織布マスク オシャレ 血色カラー | https://item.rakuten.co.jp/cicibella-sports/mskblt20/ | 595 | false | JPY | https://thumbnail.image.rakuten.co.jp/@0\_gold/cicibella-sports/top-image/day2/mskblt20\_101.jpg?\_ex=800x800 | \[1 item\] | 402788 | \[3 items\] | false | {4 fields} | {2 fields} | {3 fields} | {2 fields} | \[3 items\] | | 2 | 319439\_10002043 | cicib | msk50-6 | 319439 | 10002043 | 本日限りSALE【クーポンで最安1点95円】11/12 23:59迄 マスク 不織布 立体 3Dマスク 立体マスク 不織布マスク バイカラーマスク 血色マスク 小顔マスク マスク カラーマスク くちばし マスク 冷感マスク 99% 20枚 10枚\*2 オシャレ cicibella シシベラ 花粉 マスク | 今話題の3Dマスク 99％カットフィルター 顔にフィットで小顔効果 血色マスク 不織布マスク | https://item.rakuten.co.jp/cicib/msk50-6/ | 1980 | false | JPY | https://thumbnail.image.rakuten.co.jp/@0\_gold/cicib/top-image/day2/msk50-6\_95.jpg?\_ex=800x800 | \[1 item\] | 402788 | \[3 items\] | false | {4 fields} | {2 fields} | {3 fields} | {2 fields} | \[3 items\] | | 3 | 359958\_10043729 | centuryshop | 4573186865306-3 | 359958 | 10043729 | ＼クーポンで最安1点398円!!／11/19 09:59迄【 送料無料 個包装 】マスク 洗える ひんやりマスク マスク 夏用 洗えるマスク 冷感マスク 布マスク キッズ 大人 UVカット レディース 血色 立体 カラー こども 接触冷感 立体 子供 大人 小さめ 3d 涼感 おしゃれ 花粉 | 冬でも快適に使えるあったか立体マスクです 冬用マスク 防寒 あったか 立体 小顔 洗える 耳が痛くない 乾燥対策 保湿 秋冬 男女兼用 | https://item.rakuten.co.jp/centuryshop/4573186865306-3/ | 1000 | false | JPY | https://thumbnail.image.rakuten.co.jp/@0\_mall/centuryshop/cabinet/mask/3d/4573186865306.jpg?\_ex=800x800 | \[1 item\] | 402788 | \[3 items\] | false | {4 fields} | {2 fields} | {3 fields} | {2 fields} | \[3 items\] | Recorded from our API · 3 items shown · 21 datapoints per item GET /v1/rakuten/search?query=%E3%83%9E%E3%82%B9%E3%82%AF&min\_price=500&max\_price=2000&sort=review\_count 21 datapoints ### Identity - id string - shop\_id integer - item\_id integer - name string - subtitle string - genre\_id integer - genre\_ids number\[\] ### Contact - url url ### Reputation - image url - images string\[\] - rating object ### Price - price integer - price\_is\_from boolean - currency string ### Other - shop\_code string - manage\_number string - is\_sold\_out boolean - shop object - shipping object - points object - tags object\[\] Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/rakuten/search?query=%E3%83%9E%E3%82%B9%E3%82%AF&min_price=500&max_price=2000&sort=review_count" \ -H "X-API-Key: $API_KEY" ``` Rakuten · 5 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/rakuten/item`](https://perceptlayer.com/apis/rakuten/item) | none +3 optional | 1 credit | | [GET `/v1/rakuten/ranking`](https://perceptlayer.com/apis/rakuten/ranking) | none +4 optional | 1 credit | | [GET `/v1/rakuten/reviews`](https://perceptlayer.com/apis/rakuten/reviews) | none +7 optional | 1 credit | | [GET `/v1/rakuten/search`](https://perceptlayer.com/apis/rakuten/search) | none +8 optional | 1 credit | | [GET `/v1/rakuten/suggest`](https://perceptlayer.com/apis/rakuten/suggest) | `query` | 1 credit | Overview ## About the Rakuten API ## What you can get The Rakuten API returns Rakuten product data from Japan as JSON through 5 endpoints. - **Search:** `search` takes a `query`, with `genre_id`, `min_price`, `max_price`, `min_rating` (3, 3.5, 4, 4.5 or 5), `include_sold_out`, `page` and `sort` (relevance, price\_asc, price\_desc, newest, review\_count, review\_score, price\_shipping\_asc or price\_shipping\_desc). `suggest` takes a partial `query`. - **Items:** `item` takes a `shop_code` and `manage_number`, or an item `url`. - **Rankings:** `ranking` takes a `period` (daily, weekly, monthly or realtime), with `genre_id`, `gender` (female or male) and `page`. - **Reviews:** `reviews` takes an `id`, or a `shop_id` and `item_id`, with `page`, `rating`, `media_only` and `sort` (standard, helpful, rating or newest). The recorded search for "マスク" between 500 and 2000 yen, sorted by review\_count, returns `items`, each with `id`, `shop_code`, `manage_number`, `shop_id`, `item_id`, `name`, `subtitle`, `url`, `price`, `currency`, `image`, `genre_id`, `is_sold_out`, `shop`, `rating` ( `score` and `count`), `shipping` ( `fee`, `free` and `delivery_estimate`), `points` and `tags`. It also returns `pagination` with `total_results` (462,796 in that recording), `max_page` and `has_next`, plus `subgenres` and `related_keywords`. ## How a call works Search, then look up: `GET /v1/rakuten/search?query=マスク&min_price=500&max_price=2000&sort=review_count` with your key in the `X-API-Key` header returns each item's `shop_code` and `manage_number`, which `item` takes, and its `id`, which `reviews` takes. Search `subgenres` carry an `id` you can pass as `genre_id` to `search` or `ranking`. Every successful call costs 1 credit; failed calls cost nothing. Marketplaces JSON REST MCP ### More marketplaces APIs [About You](https://perceptlayer.com/apis/about-you) [adidas](https://perceptlayer.com/apis/adidas) [AliExpress](https://perceptlayer.com/apis/aliexpress) [Allegro](https://perceptlayer.com/apis/allegro) [Amazon](https://perceptlayer.com/apis/amazon) [ASOS](https://perceptlayer.com/apis/asos) [Billiger.de](https://perceptlayer.com/apis/billiger) [bol.com](https://perceptlayer.com/apis/bol) [Chrono24](https://perceptlayer.com/apis/chrono24) [Costco](https://perceptlayer.com/apis/costco) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) Use cases ### Track Rakuten prices and shipping fees for a product list `Use the Rakuten API to track Rakuten prices and shipping fees for a product list` ### Watch daily, weekly or realtime rankings in a genre `Use the Rakuten API to watch daily, weekly or realtime rankings in a genre` ### Compare points and free shipping across shops for one product `Use the Rakuten API to compare points and free shipping across shops for one product` ### Analyse reviews by rating, or only reviews with media `Use the Rakuten API to analyse reviews by rating, or only reviews with media` FAQ ## Questions **How much does the Rakuten API cost?** Each successful call costs one credit, and each search page is one call. New accounts get free credits to start, and credit packs bring the price down as you scale. **Can I search in Japanese?** Yes. Pass a Japanese \`query\` to \`search\` or \`suggest\`; results come back in JPY. **Do I need a Rakuten account?** No. You call this Rakuten API with your Perceptlayer key in the \`X-API-Key\` header, with no Rakuten login. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Should I build a Rakuten scraper instead?** You can, but a Rakuten scraper is code you maintain: page changes break it, requests get blocked, and Rakuten's terms govern how you collect data. The Rakuten API gives you 5 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the Rakuten API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)