Rakuten Marketplace Item Ranking

FREE
By rakuten_webservice
Updated 4 months ago
8/10
Popularity
251ms
Latency
96%
Success Rate

Rakuten Marketplace Item Ranking API Documentation

The Rakuten Marketplace Ranking API can acquire data from the Ranking section within Rakuten Marketplace. Developers can acquire sales data divided by genre, gender, or age category.

View API Details
GET/Ranking/20170628
GET/Ranking/20170628

The Rakuten Item Ranking API can acquire data from the Ranking section within Rakuten Marketplace. Developers can acquire sales data divided by genre, gender, or age category.

Header Parameters
X-RapidAPI-HostSTRING
REQUIRED
X-RapidAPI-KeySTRING
REQUIRED
Optional Parameters
affiliateIdSTRING
OPTIONALRakuten Affiliate ID number. When specified item links in the response payload will include this ID. You can receive affiliate rewards when an item is purchased through your link.
ageSTRING
OPTIONAL10:10-19 20:20-29 30:30-39 40:40-49 50:50 and up (*1) If no value for genre ID, gender, or age group is specified, all ranking information will be shown. (*2) Age grouping and gender specifications can be used simultenously. (*3) For other input parameter settings, please check the section on this page labeled "Items to be aware of regarding input parameters."
callbackSTRING
OPTIONALFunction name to be used with the JSONP output (UTF-8 URL encoded string) Alphanumeric characters, periods, or underscores
carrierSTRING
OPTIONALChoose the target platform for type of information to return: PC, mobile, or smartphone PC: 0 mobile: 1 (*Japan only) smartphone: 2
elementsSTRING
OPTIONALBy default, API response all of the fields. You can change response fields by this parameter. This parameter's data is separated by comma(,). For example, following request will response only itemName, itemPrice and itemUrl. elements=itemName,itemPrice,itemUrl
formatSTRING
OPTIONALEither JSON or XML When JSON is specified the callback parameter can also be set in order to use JSONP.
genreidNUMBER
OPTIONALThe ID for specifying the genres used in Rakuten Ichiba If it is necessary to lookup genre names and genre relationships, please use the Rakuten Genre search API (GenreSearch). (*1) If no value for genre ID, gender, or age group is specified, all ranking information will be shown. (*2) For other input parameter settings, please check the section on this page labeled "Items to be aware of regarding input parameters."
pageNUMBER
OPTIONALAn integer between 1 and 34 *It is possible to specify rankings below 30th place.
periodSTRING
OPTIONALrealtime: retrieve data in real time
sexSTRING
OPTIONAL0: Male 1: Female (*1) If no value for genre ID, gender, or age group is specified, all ranking information will be shown. (*2) Age grouping and gender specifications can be used simultenously. (*3) For other input parameter settings, please check the section on this page labeled "Items to be aware of regarding input parameters."
Code Snippet
Install SDK
Response ExampleSchema

Install SDK for (Node.js)Unirest

OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication