Get started

The Rakuten Data API is organized around REST. Our API is not Rakuten's official API, but gets data from the official Rakuten website. It has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

get rakuten stocking

To get the Rakuten stocking you need to make a GET call to the following url :
https://api.staging.rpa.hkrnd.com/stocking/rakuten


QUERY PARAMETERS

Field Type Description
url String Rakuten item link

RESPONSE PARAMETERS

Field Type Description
isAvailability Boolean Item whether available to buy
qty Integer Maximum qty of the item can buy(-1 is not limited)
genreId Integer Genre id of the item in Rakuten
taxIncluded Boolean Item price whether included tax
itemName String Item name displayed on rakuten
itemPrice Integer Item price in JPY
itemOptions String Array Item options

Errors

The Rakuten Data API uses the following error codes:

Error Code Meaning
10000 Network error of the API service. Please try again later.
10001 Unknown or invalid url. This error appears if you use an unknow of invalid URL of rakuten .

Examples

The Rakuten Data API examples uses the following endpoints:

Endpoints Method Code Result
https://api.staging.rpa.hkrnd.com/stocking/rakuten?url=https://item.rakuten.co.jp/rakutenmobile-store/apple-rm2104021 GET 200 { "isAvailability": true, "qty": -1, "genreId": 560287, "taxIncluded": true, "itemName": "【送料無料】Apple AirTagレザーループ サドルブラウン (PRODUCT)RED MX4A2FE/A MK0V3FE/A アクセサリー 新品 国内正規品 認定店 楽天モバイル", "itemPrice": 6880, "itemOptions": [ "サドルブラウン", "(PRODUCT)RED" ] }
https://api.staging.rpa.hkrnd.com/stocking/rakuten?url=https://item.rakuten.co.jp/otonaluxe/t22302ko/ GET 200 { "isAvailability": false, "qty": 0, "genreId": 566028, "taxIncluded": true, "itemName": "トップス ニット レディース アイボリー 秋冬 長袖 薄手 ボトルネック 暖か ハイゲージ 着回し ボタン おしゃれ 上品 主役もレイヤードもベーシックこそお酒落の即戦力 11/20[0]++8", "itemPrice": 5082, "itemOptions": [] }
https://api.staging.rpa.hkrnd.com/stocking/rakuten?url=https://item.rakuten.co.jp/roomy/rtm20mar30h01/ GET 200 { "isAvailability": true, "qty": 9, "genreId": 208375, "taxIncluded": true, "itemName": "RHYTHM Silky Wind Mobile 2 / リズム シルキーウィンドモバイル2 9ZF028RH", "itemPrice": 1980, "itemOptions": [ "【選択A】通常注文", "【選択B】入荷待ち注文", "クロ", "シロ", "ミズイロ", "サクラ" ] }