Sign inGet a free API keyDashboard
Menu

APIs / Marketplaces / Rakuten

1 credit per call5 endpoints21 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 keyRun 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 OKJSONX-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.

#idstringshop_codestringmanage_numberstringshop_idintegeritem_idintegernamestringsubtitlestringurlurlpriceintegerprice_is_frombooleancurrencystringimageurlimagesstring[]genre_idintegergenre_idsnumber[]is_sold_outbooleanshopobjectratingobjectshippingobjectpointsobjecttagsobject[]
1386567_10000801cicibella-sportsmskblt2038656710000801＼高評価／【先着限定クーポンで最安101円】11/12 23:59迄 マスク 秋用マスク 立体 3Dマスク 立体マスク 不織布マスク バイカラーマスク 血色マスク 小顔マスク 立体 マスク カラーマスク くちばしマスク 99% 20枚 10枚*2 cicibella 防災グッズ 花粉 マスク今話題の3Dマスク 99％カットフィルター 顔にフィットで小顔効果 血色マスク 不織布マスク オシャレ 血色カラーhttps://item.rakuten.co.jp/cicibella-sports/mskblt20/595falseJPYhttps://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]
2319439_10002043cicibmsk50-631943910002043本日限りSALE【クーポンで最安1点95円】11/12 23:59迄 マスク 不織布 立体 3Dマスク 立体マスク 不織布マスク バイカラーマスク 血色マスク 小顔マスク マスク カラーマスク くちばし マスク 冷感マスク 99% 20枚 10枚*2 オシャレ cicibella シシベラ 花粉 マスク今話題の3Dマスク 99％カットフィルター 顔にフィットで小顔効果 血色マスク 不織布マスクhttps://item.rakuten.co.jp/cicib/msk50-6/1980falseJPYhttps://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]
3359958_10043729centuryshop4573186865306-335995810043729＼クーポンで最安1点398円!!／11/19 09:59迄【 送料無料 個包装 】マスク 洗える ひんやりマスク マスク 夏用 洗えるマスク 冷感マスク 布マスク キッズ 大人 UVカット レディース 血色 立体 カラー こども 接触冷感 立体 子供 大人 小さめ 3d 涼感 おしゃれ 花粉冬でも快適に使えるあったか立体マスクです 冬用マスク 防寒 あったか 立体 小顔 洗える 耳が痛くない 乾燥対策 保湿 秋冬 男女兼用https://item.rakuten.co.jp/centuryshop/4573186865306-3/1000falseJPYhttps://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 itemGET /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

  • idstring
  • shop_idinteger
  • item_idinteger
  • namestring
  • subtitlestring
  • genre_idinteger
  • genre_idsnumber[]

Contact

  • urlurl

Reputation

  • imageurl
  • imagesstring[]
  • ratingobject

Price

  • priceinteger
  • price_is_fromboolean
  • currencystring

Other

  • shop_codestring
  • manage_numberstring
  • is_sold_outboolean
  • shopobject
  • shippingobject
  • pointsobject
  • tagsobject[]

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/rakuten/item
none+3 optional
1 credit
GET/v1/rakuten/ranking
none+4 optional
1 credit
GET/v1/rakuten/reviews
none+7 optional
1 credit
GET/v1/rakuten/search
none+8 optional
1 credit
GET/v1/rakuten/suggest
query
1 credit

Overview

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.

MarketplacesJSONRESTMCP

More marketplaces APIs

About YouadidasAliExpressAllegroAmazonASOSBilliger.debol.comChrono24CostcoCraigslistDBA

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 keyRead the docs