BooksGame/Search

Description

Gets up to 30 game items by title, hardware, maker, label, JAN or genre.

Resource URL

https://app.rakuten.co.jp/services/api/BooksGame/Search/20130522

Resource Information

Auth Type App Key
Affiliation Support Yes

Parameters

App ID (string)

The Application ID that identifies your application. You can get it from https://webservice.rakuten.co.jp/.

Game Title (string)

Keywords to search from the game title.

This string needs to be UTF-8 encoded.

If you want to use multiple keywords in your search, please separate them using spaces.

Compatible Platforms (Hardware) (string)

Search for compatible platforms (hardware).

This string needs to be UTF-8 encoded.

If you want to use multiple keywords in your search, please separate them using spaces.

MPN (Manufacturer Part Number) (string)

Search for MPN (Manufacturer Part Number).

This string needs to be UTF-8 encoded.

Publisher name (string)

Keywords to search from publisher releasing the items.

This string needs to be UTF-8 encoded.

If you want to use multiple keywords in your search, please separate them using spaces.

Game JAN code (long)

Search for a game JAN code.

Book genre ID (string)

Use it for narrow results to a specific book genre ID.

Only genres under bookGenreId = 006 (games) are valid.

Please use the Book Genre Search API to look up book genre names and genre relations.

Please note that this genre is different from the Rakuten Ichiba genre.

Default Value: 006

How many results to display on each page (integer)

An integer between 1 and 30.

Default Value: 30

Result page (integer)

An integer between 1 and 100.

Default Value: 1

Availability (integer)

Valid Values:

  • 0 all items
  • 1 In Stock
  • 2 Usually ships in about 3 to 7 days
  • 3 Usually ships in about 3 to 9 days
  • 4 Manufacturer stock
  • 5 Preorder
  • 6 Check stock with manufacturer

Default Value: 0

Out of Stock Flag (integer)

Valid Values:

  • 0 Do not include out of stock items.
  • 1 Include out of stock items.

Default Value: 0

Sort (string)

*UTF-8 URL encoding is required.

Valid Values:

  • standard
  • sales
  • +releaseDate Release date (Ascending order)
  • -releaseDate Release date (Descending order)
  • +itemPrice Item price (Ascending order)
  • -itemPrice Item price (Descending order)
  • reviewCount
  • reviewAverage

Default Value: standard

Limited Flag (integer)

※ Limited Edition include products such as limited time, limited quantity or reservation limited.

Valid Values:

  • 0 All items
  • 1 Limited Edition only

Default Value: 0

Platform (integer)

Valid Values:

  • 0 PC
  • 1 Mobile

Default Value: 0

Genre information flag (integer)

Valid Values:

  • 0 Do not get number of item in each genre.
  • 1 Get number of item in each genre.

Default Value: 0

Affiliate ID (string)

If this endpoint supports affiliation, here you can enter your affiliate ID. If you do, the links in the API response will include your affiliate ID.

Response format (string)

Format for the response output.

You can set this parameter to json or xml. JSON is usually the best option.

If you choose JSON, you can also set the callback parameter in order to use JSONP.

Valid Values:

  • json
  • xml

Default Value: json

Callback function name (string)

Function name to be used with the JSONP output

Please make sure you enter a UTF-8 URL encoded string, containing only a combination of alphanumeric characters, periods and underscores.

Choosing output fields (string)

By default API will return all the fields. You can specify what fields should be returned by using this parameter.

If you want to specify more than one parameter, please use comma (,) as separator.

For example, following request will only return itemName, itemPrice and itemUrl.

elements=itemName,itemPrice,itemUrl

Format version (integer)

Response format version.

If formatVersion=2 is set, the response format (JSON) will be improved.

In case of formatVersion=1:

The API response will return an array using the following format.

For example, you would need to use notation items[0].item.itemName to access itemName parameter.

{"items": [

{"item": {

"itemName": "a",

"itemPrice": 10

}},

{"item": {

"itemName": "b",

"itemPrice": 20

}}

]}

In case of formatVersion=2:

The API response will return an array using the following format.

For example, you would use the notation items[0].itemName to access the itemName parameter.

{"items": [

{

"itemName": "a",

"itemPrice": 10

},

{

"itemName": "b",

"itemPrice": 20

}

]}

Valid Values:

  • 1
  • 2

Default Value: 1

applicationId

App ID
string Required

The Application ID that identifies your application. You can get it from https://webservice.rakuten.co.jp/.

title

Game Title
string At least one is required

Keywords to search from the game title.

This string needs to be UTF-8 encoded.

If you want to use multiple keywords in your search, please separate them using spaces.

hardware

Compatible Platforms (Hardware)
string At least one is required

Search for compatible platforms (hardware).

This string needs to be UTF-8 encoded.

If you want to use multiple keywords in your search, please separate them using spaces.

makerCode

MPN (Manufacturer Part Number)
string At least one is required

Search for MPN (Manufacturer Part Number).

This string needs to be UTF-8 encoded.

label

Publisher name
string At least one is required

Keywords to search from publisher releasing the items.

This string needs to be UTF-8 encoded.

If you want to use multiple keywords in your search, please separate them using spaces.

jan

Game JAN code
long At least one is required

Search for a game JAN code.

booksGenreId

Book genre ID
string At least one is required

Use it for narrow results to a specific book genre ID.

Only genres under bookGenreId = 006 (games) are valid.

Please use the Book Genre Search API to look up book genre names and genre relations.

Please note that this genre is different from the Rakuten Ichiba genre.

Default Value: 006

hits

How many results to display on each page
integer Optional

An integer between 1 and 30.

Default Value: 30

page

Result page
integer Optional

An integer between 1 and 100.

Default Value: 1

availability

Availability
integer Optional

Valid Values:

  • 0 all items
  • 1 In Stock
  • 2 Usually ships in about 3 to 7 days
  • 3 Usually ships in about 3 to 9 days
  • 4 Manufacturer stock
  • 5 Preorder
  • 6 Check stock with manufacturer

Default Value: 0

outOfStockFlag

Out of Stock Flag
integer Optional

Valid Values:

  • 0 Do not include out of stock items.
  • 1 Include out of stock items.

Default Value: 0

sort

Sort
string Optional

*UTF-8 URL encoding is required.

Valid Values:

  • standard
  • sales
  • +releaseDate Release date (Ascending order)
  • -releaseDate Release date (Descending order)
  • +itemPrice Item price (Ascending order)
  • -itemPrice Item price (Descending order)
  • reviewCount
  • reviewAverage

Default Value: standard

limitedFlag

Limited Flag
integer Optional

※ Limited Edition include products such as limited time, limited quantity or reservation limited.

Valid Values:

  • 0 All items
  • 1 Limited Edition only

Default Value: 0

carrier

Platform
integer Optional

Valid Values:

  • 0 PC
  • 1 Mobile

Default Value: 0

genreInformationFlag

Genre information flag
integer Optional

Valid Values:

  • 0 Do not get number of item in each genre.
  • 1 Get number of item in each genre.

Default Value: 0

affiliateId

Affiliate ID
string Optional

If this endpoint supports affiliation, here you can enter your affiliate ID. If you do, the links in the API response will include your affiliate ID.

format

Response format
string Optional

Format for the response output.

You can set this parameter to json or xml. JSON is usually the best option.

If you choose JSON, you can also set the callback parameter in order to use JSONP.

Valid Values:

  • json
  • xml

Default Value: json

callback

Callback function name
string Optional

Function name to be used with the JSONP output

Please make sure you enter a UTF-8 URL encoded string, containing only a combination of alphanumeric characters, periods and underscores.

elements

Choosing output fields
string Optional

By default API will return all the fields. You can specify what fields should be returned by using this parameter.

If you want to specify more than one parameter, please use comma (,) as separator.

For example, following request will only return itemName, itemPrice and itemUrl.

elements=itemName,itemPrice,itemUrl

formatVersion

Format version
integer Optional

Response format version.

If formatVersion=2 is set, the response format (JSON) will be improved.

In case of formatVersion=1:

The API response will return an array using the following format.

For example, you would need to use notation items[0].item.itemName to access itemName parameter.

{"items": [

{"item": {

"itemName": "a",

"itemPrice": 10

}},

{"item": {

"itemName": "b",

"itemPrice": 20

}}

]}

In case of formatVersion=2:

The API response will return an array using the following format.

For example, you would use the notation items[0].itemName to access the itemName parameter.

{"items": [

{

"itemName": "a",

"itemPrice": 10

},

{

"itemName": "b",

"itemPrice": 20

}

]}

Valid Values:

  • 1
  • 2

Default Value: 1

Response Example

Request

https://app.rakuten.co.jp/services/api/BooksGame/Search/20130522?applicationId=REPLACE_WITH_YOUR_APP_ID&title=mario&hits=3

Response
{
  "count": 64,
  "page": 1,
  "first": 1,
  "last": 3,
  "hits": 3,
  "carrier": 0,
  "pageCount": 22,
  "Items": [
    {
      "Item": {
        "title": "マリオテニス ウルトラスマッシュ",
        "titleKana": "マリオテニス ウルトラスマッシュ",
        "hardware": "Wii U",
        "label": "任天堂",
        "jan": "4902370531992",
        "makerCode": "WUP-P-AVXJ",
        "itemCaption": "\n\nジャンプに、巨大に、amiiboに。\nみんなで遊べる 『マリオテニス』 の最新作。\n\nシンプルな操作で多彩なショットを打ち分け、誰でもラリーの楽しさを味わえる 『マリオテニス』 シリーズ。\n最新作となる『マリオテニス ウルトラスマッシュ』では、ローカル対戦や協力、インターネット対戦はもちろんのこと、ジャンプショットや巨大化するメガバトル、amiiboの育成など、テニスを軸としたさまざまな遊びを追加しています。\n\n●ひとりでも、みんなでもシングルスやダブルスなど最大4人で遊べます。\nインターネット対戦にも対応。世界中のプレイヤーと気軽に対戦できます。\n\n\n\n\n\n\n\n●amiiboを育成「勝ち抜きチャレンジ×amiibo」では、amiiboを自分のパートナーとして一緒に試合ができます。\n\n\n\n●2つの新要素で遊びが広がる・ダイナミックな試合を展開できるジャンプショット\n・巨大化して試合を有利に進めるメガバトルモード\n\n\n\n\n\n©2015-2016 Nintendo / CAMELOT",
        "salesDate": "2016年01月28日",
        "itemPrice": 4568,
        "listPrice": 0,
        "discountRate": 0,
        "discountPrice": 0,
        "itemUrl": "http://books.rakuten.co.jp/rb/13478219/",
        "affiliateUrl": "",
        "smallImageUrl": "http://thumbnail.image.rakuten.co.jp/@0_mall/book/cabinet/1992/4902370531992.jpg?_ex=64x64",
        "mediumImageUrl": "http://thumbnail.image.rakuten.co.jp/@0_mall/book/cabinet/1992/4902370531992.jpg?_ex=120x120",
        "largeImageUrl": "http://thumbnail.image.rakuten.co.jp/@0_mall/book/cabinet/1992/4902370531992.jpg?_ex=200x200",
        "availability": "5",
        "postageFlag": 2,
        "limitedFlag": 0,
        "reviewCount": 0,
        "reviewAverage": "0.0",
        "booksGenreId": "006511006004"
      }
    },
    {
      "Item": {
        "title": "『マリオ&ルイージRPG ペーパーマリオMIX・ マリオカート7』 ダブルパック",
        "titleKana": "『マリオ&ルイージRPG ペーパーマリオMIX・ マリオカート7』 ダブルパック",
        "hardware": "Nintendo 3DS",
        "label": "任天堂",
        "jan": "4902370531862",
        "makerCode": "CTR-P-AWBJ",
        "itemCaption": "『マリオ&ルイージRPG ペーパーマリオMIX』と『マリオカート7』のお得なダブルパック\n\n©2015 Nintendo Developed by ALPHADREAM\n©2011 Nintendo",
        "salesDate": "2015年12月03日",
        "itemPrice": 7560,
        "listPrice": 0,
        "discountRate": 0,
        "discountPrice": 0,
        "itemUrl": "http://books.rakuten.co.jp/rb/13478216/",
        "affiliateUrl": "",
        "smallImageUrl": "http://thumbnail.image.rakuten.co.jp/@0_mall/book/cabinet/1862/4902370531862.jpg?_ex=64x64",
        "mediumImageUrl": "http://thumbnail.image.rakuten.co.jp/@0_mall/book/cabinet/1862/4902370531862.jpg?_ex=120x120",
        "largeImageUrl": "http://thumbnail.image.rakuten.co.jp/@0_mall/book/cabinet/1862/4902370531862.jpg?_ex=200x200",
        "availability": "1",
        "postageFlag": 2,
        "limitedFlag": 0,
        "reviewCount": 0,
        "reviewAverage": "0.0",
        "booksGenreId": "006508005002/006508006001"
      }
    },
    {
      "Item": {
        "title": "マリオ花札・黒",
        "titleKana": "スーパーマリオ ハナフダ",
        "hardware": "玩具",
        "label": "任天堂",
        "jan": "4902370531770",
        "makerCode": "KRT-Z-NMHK",
        "itemCaption": "全札オリジナル柄 遊び方説明書入り。\n\n\n\n© Nintendo",
        "salesDate": "2015年11月20日",
        "itemPrice": 2430,
        "listPrice": 0,
        "discountRate": 0,
        "discountPrice": 0,
        "itemUrl": "http://books.rakuten.co.jp/rb/13425877/",
        "affiliateUrl": "",
        "smallImageUrl": "http://thumbnail.image.rakuten.co.jp/@0_mall/book/cabinet/1770/4902370531770.jpg?_ex=64x64",
        "mediumImageUrl": "http://thumbnail.image.rakuten.co.jp/@0_mall/book/cabinet/1770/4902370531770.jpg?_ex=120x120",
        "largeImageUrl": "http://thumbnail.image.rakuten.co.jp/@0_mall/book/cabinet/1770/4902370531770.jpg?_ex=200x200",
        "availability": "1",
        "postageFlag": 1,
        "limitedFlag": 0,
        "reviewCount": 1,
        "reviewAverage": "5.0",
        "booksGenreId": "006510006001"
      }
    }
  ],
  "GenreInformation": []
}

Try It

Set the Parameters

  Show More Parameters

Request

https://app.rakuten.co.jp/services/api/BooksGame/Search/20130522?applicationId=REPLACE_WITH_YOUR_APP_ID

Response