APIs / Rakuten / Search

Rakuten: Search

Search from Rakuten as JSON. 1 credit per successful call.

GET /v1/rakuten/search

Parameters

Send parameters in the query string.

ParameterTypeRequiredAllowed values
querystringOptionalUp to 200 characters
genre_idintegerOptionalAny
min_priceintegerOptionalAny
max_priceintegerOptionalAny
sortstringOptionalrelevance, price_asc, price_desc, newest, review_count, review_score, price_shipping_asc, price_shipping_desc
pageintegerOptionalAny
min_ratingnumberOptional3, 3.5, 4, 4.5, 5
include_sold_outbooleanOptionalAny

Example request

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.

Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.