# Rakuten API: Search products

> Searches Rakuten Ichiba products by keyword, price range, free shipping and sort order. Returns up to 45 regular listings in the order shown; sponsored placements are excluded. Prices are listed starting prices when an item has variants.

Unofficial. Not affiliated with or endorsed by Rakuten.

- Page: https://fous.com/methods/rakuten.co.jp/search-products
- Method: `rakuten.co.jp/search_products`, version 1
- Website: rakuten.co.jp
- Returns: name, price, shop, rating, reviews, free shipping, points, image, link, item code
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `sort` | string | no | `"price_low_to_high"` | Results order, for example price_low_to_high. One of "standard", "price_low_to_high", "price_high_to_low", "most_reviews", "newest". Default "standard". |
| `query` | string | yes | `"ワイヤレスイヤホン"` | Product keywords in Japanese or English, for example ワイヤレスイヤホン or Nintendo Switch. |
| `max_price` | integer | no | `6000` | Highest listed price in yen, for example 6000. |
| `min_price` | integer | no | `3000` | Lowest listed price in yen, for example 3000. Default 0. |
| `max_results` | integer | no | `5` | Maximum products to return, for example 20 (at most 45). Default 20. |
| `free_shipping_only` | boolean | no | `true` | Show only products marked free shipping, for example true. Default false. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "sort": "price_low_to_high",
  "query": "ワイヤレスイヤホン",
  "max_price": 6000,
  "min_price": 3000,
  "max_results": 5,
  "free_shipping_only": true
}
```

Its output:

```json
{
  "products": [
    {
      "name": "【送料無料】 ワイヤレスイヤホン bluetooth 5.1 無線 イヤフォン iphone スマホ android アンドロイド ブルートゥース Siri 高音質 防水 スポーツ 左右分離 YOUJ",
      "price": 3000,
      "points": "27ポイント(1倍)〜",
      "currency": "JPY",
      "item_code": "shopkurano:m-mi0403-10a",
      "shop_name": "SHOP KURANO",
      "image_link": "https://tshop.r10s.jp/shopkurano/cabinet/2067/m-mi0403-10a-10.jpg?fitin=275:275",
      "star_rating": 3.28,
      "product_link": "https://item.rakuten.co.jp/shopkurano/m-mi0403-10a/",
      "review_count": 29,
      "free_shipping": true
    },
    {
      "name": "ブルートゥース ワイヤレスイヤホン 送料無料 スポーツ イヤホン ウォーキング 運動 マグネット搭載 ハンズフリー 運動 通話 マイク付き 首かけ ネックバンドイヤホン ノイズキャンセリング 高音質 ヘッドホン 防水防汗 スマホ スマートフォン 在宅 テレワーク bluetooth",
      "price": 3000,
      "points": "27ポイント(1倍)",
      "currency": "JPY",
      "item_code": "bellezzavoce:cjfj228",
      "shop_name": "ベレザヴォーチェ",
      "image_link": "https://tshop.r10s.jp/gold/bellezzavoce/lib/image/cjfj228.jpg?fitin=275:275",
      "star_rating": 3,
      "product_link": "https://item.rakuten.co.jp/bellezzavoce/cjfj228/",
      "review_count": 4,
      "free_shipping": true
    },
    {
      "name": "Sony ソニー WF-1000xm4 ケース WF-1000xm4 カバー sony ヘッドホン WF-1000xm4 ケース シリコン ソフトケース カラビナ付き 保護 2021最新 収納 専用ケース カバー イヤホン キズ防止 耐衝撃 保護カバー 保護ケース シンプル 落下防止 かわいい 防",
      "price": 3000,
      "points": "30ポイント(1倍)",
      "currency": "JPY",
      "item_code": "yakia:h-snbh",
      "shop_name": "yakia",
      "image_link": "https://tshop.r10s.jp/yakia/cabinet/h-snbh/h-snbh-1.jpg?fitin=275:275",
      "star_rating": null,
      "product_link": "https://item.rakuten.co.jp/yakia/h-snbh/",
      "review_count": 0,
      "free_shipping": true
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"rakuten.co.jp/search_products","input":{"sort":"price_low_to_high","query":"ワイヤレスイヤホン","max_price":6000,"min_price":3000,"max_results":5,"free_shipping_only":true}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Find me wireless earbuds on Rakuten under ¥6,000 with free shipping, cheapest first
- 楽天市場で「ふるさと納税 米 10kg」を検索して、レビュー件数が多い順に30件見せて
- I need a rice cooker between 10,000 and 25,000 yen, sorted by most reviews, free shipping only
- Show the newest listings for Nintendo Switch Pro controller, top 15 results with shop names and ratings
- Pull up to 45 results for 電動歯ブラシ priced 3000 to 8000 yen, lowest price first, and include points and item codes

## Input schema

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "sort": {
      "enum": [
        "standard",
        "price_low_to_high",
        "price_high_to_low",
        "most_reviews",
        "newest"
      ],
      "type": "string",
      "default": "standard",
      "description": "Results order, for example price_low_to_high."
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Product keywords in Japanese or English, for example ワイヤレスイヤホン or Nintendo Switch."
    },
    "max_price": {
      "type": "integer",
      "minimum": 0,
      "description": "Highest listed price in yen, for example 6000."
    },
    "min_price": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "description": "Lowest listed price in yen, for example 3000."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 45,
      "minimum": 1,
      "description": "Maximum products to return, for example 20 (at most 45)."
    },
    "free_shipping_only": {
      "type": "boolean",
      "default": false,
      "description": "Show only products marked free shipping, for example true."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "products"
  ],
  "properties": {
    "products": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "price",
          "currency",
          "shop_name",
          "star_rating",
          "review_count",
          "free_shipping",
          "points",
          "image_link",
          "product_link",
          "item_code"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Product name as shown on Rakuten."
          },
          "price": {
            "type": "integer",
            "description": "Listed price in yen; lowest price for variants."
          },
          "points": {
            "type": [
              "string",
              "null"
            ],
            "description": "Points text as shown, such as 254ポイント(1倍); null when not shown."
          },
          "currency": {
            "enum": [
              "JPY"
            ],
            "type": "string",
            "description": "Currency for price."
          },
          "item_code": {
            "type": "string",
            "description": "Rakuten shop and item code, for example book:18210481."
          },
          "shop_name": {
            "type": "string",
            "description": "Seller shop name."
          },
          "image_link": {
            "type": [
              "string",
              "null"
            ],
            "description": "Product image link."
          },
          "star_rating": {
            "type": [
              "number",
              "null"
            ],
            "description": "Average star rating; null when not rated."
          },
          "product_link": {
            "type": "string",
            "description": "Product page link."
          },
          "review_count": {
            "type": "integer",
            "description": "Number of reviews; zero when not rated."
          },
          "free_shipping": {
            "type": "boolean",
            "description": "Whether the listing says shipping is free."
          }
        },
        "additionalProperties": false
      },
      "description": "Products in the order shown by Rakuten."
    }
  },
  "additionalProperties": false
}
```

## See more

- [AliExpress API: Search products](https://fous.com/methods/aliexpress.com/search-products.md): Searches AliExpress listings by product words, shipping destination, price range and sort order. Unpriced promotional cards are omitted; free shipping is marked only when the listing explicitly says so.
- [Kohl's API: Search products](https://fous.com/methods/kohls.com/search-products.md): Searches Kohl's products in site order and returns prices, offers, ratings and links for each result.
- [Nordstrom API: Search products](https://fous.com/methods/nordstrom.com/search-products.md): Search Nordstrom products by words, price, sale status and sort order. Prices are the lowest listed price. Available sizes may be empty when a product page is unavailable.
- [Flipkart API: Search products](https://fous.com/methods/flipkart.com/search-products.md): Searches Flipkart products by keyword, with an optional price range and sort order. Returns current listings in site order.
- [Best Buy API: Search products](https://fous.com/methods/bestbuy.com/search-products.md): Searches Best Buy US products with an optional price range, sort order and page. Prices and availability come from public listings and may vary by location.
- [Mercari API: Search listings](https://fous.com/methods/mercari.com/search-listings.md): Searches Mercari US listings for items for sale or sold, with condition, price and sorting filters, and adds seller, size and shipping details from each item page. Sold prices are displayed listing prices.
- [Macy's API: Search products](https://fous.com/methods/macys.com/search-products.md): Searches Macy's products in the site's order with optional USD price bounds, sale-only results and sorting. Prices for products with a range use the lowest shown price.
- [Chewy API: Search products](https://fous.com/methods/chewy.com/search-products.md): Search Chewy products by words, pet type, and sort order. Returns up to 72 products in Chewy's order, including listed and first-order Autoship prices when shown.