Rakuten Marketplace Item Search

FREE
By rakuten_webservice
Updated 3 months ago
8.7/10
Popularity Score
173ms
Latency
94%
Success Rate

Rakuten Marketplace Item Search API Documentation

Rakuten Marketplace Item Search APIs allow developers to get access data from the Japanese Rakuten Marketplace (Ichiba).

View API Details
GET/IchibaItem/Search/20170706
GET/IchibaItem/Search/20170706

Rakuten Marketplace Item Search API enables developers to retrieve information of selling items on Rakuten Marketplace (Ichiba) excluding those listed on auctions, flea markets, customer to customer auctions (C2C) or joint purchases on Rakuten Ichiba. Developers are allowed to obtain the item information by specifying Keyword as well as to filter the search with Item Code, Shop Name or Genre Name.

Header Parameters
X-RapidAPI-HostSTRING
REQUIRED
X-RapidAPI-KeySTRING
REQUIRED
Optional Parameters
keywordSTRING
OPTIONALUTF-8 URL encoded string The keyword parameter can have a maximum length of 128 single byte characters The keyword parameter is delimited with single byte space characters. This defaults to an AND operation including all the keywords. To use OR instead set the orFlag to 1. Each search keyword must be at least two single byte characters or one double byte character. An exception is a minimum of two characters if the search keywords are using hiragana, katakana, or symbols. (*1) One of the following is required: search keyword, genre ID, item code, or shop code.
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."
itemcodeSTRING
OPTIONALIncluded in the output parameters of the Item Search, Item Ranking, and Bookmark APIs. A value in the form of "shop:1234" (*1) A search request must contain either a keyword, a genre ID, or an item code.
shopcodeSTRING
OPTIONALThe portion of the shop URL listed as "xyz": http://www.rakuten.co.jp/[xyz] (*1) One of the following is required: search keyword, genre ID, item code, or shop code.
affiliateIdSTRING
OPTIONALRakuten Affiliate ID. When specified links in the response body will include tracking for your affiliate ID so you can receive credit for affiliate traffic.
formatSTRING
OPTIONALEither JSON or XML.
fieldNUMBER
OPTIONAL0: Broad search (prefer more matches with the same keyword) 1: Restricted search (prefer fewer matches with the same keyword)
sortSTRING
OPTIONAL+affiliateRate: Affiliate Rate (Ascending order) -affiliateRate: Affiliate Rate (Descending order) +reviewCount: Number of reviews (Ascending order) -reviewCount: Number of reviews (Descending order) +reviewAverage: Average review rating (Ascending order) -reviewAverage: Average review rating (Descending order) +itemPrice: Price (Ascending order) -itemPrice: Price (Descending order) +updateTimestamp: Time of item update (Ascending order) -updateTimestamp: Time of item update (Descending order) standard: Rakuten standard sort *UTF-8 URL encoding is required.
Code Snippet
Install SDK
Response Example

Install SDK for (Node.js)Unirest

OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication