search.rakuten.co.jp APIsearch.rakuten.co.jp ↗
Search Rakuten Ichiba's Japanese marketplace. Returns product names, URLs, prices, shop IDs, and Furusato Nozei eligibility flags via a single endpoint.
curl -X GET 'https://api.parse.bot/scraper/3d94b0f3-f45a-45a4-9ba2-7e2ab41606fd/search_products?page=1&query=%E3%83%86%E3%83%AC%E3%83%93' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on Rakuten Ichiba. Returns paginated results including product names, URLs, prices, and shop IDs, with a flag indicating whether each item is Furusato Nozei (Hometown Tax) eligible. Results follow Rakuten's default relevance ranking.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number to fetch. Must be a positive integer. |
| queryrequired | string | Search keyword to query Rakuten's product catalog (e.g. 'テレビ', 'コーヒー'). |
{
"type": "object",
"fields": {
"page": "integer, page number returned",
"count": "integer, number of items on this page",
"items": "array of product objects with name, url, is_furusato_nozei, price, shop_id, item_id",
"query": "string, the search keyword used"
},
"sample": {
"data": {
"page": 1,
"count": 50,
"items": [
{
"url": "https://grp07.ias.rakuten.co.jp/redirect_rpp/?s=...",
"name": "【ふるさと納税】2年連続 総合1位 ホタテ 訳あり 4個まで選び放題",
"price": "8000",
"item_id": "379988/10003150",
"shop_id": "379988",
"is_furusato_nozei": true
}
],
"query": "ふるさと納税"
},
"status": "success"
}
}About the search.rakuten.co.jp API
The Rakuten Ichiba Search API gives you access to Rakuten Japan's product catalog through one endpoint, search_products, which returns up to 7 structured fields per item — including name, price, shop ID, item ID, product URL, and a Furusato Nozei eligibility flag. Queries accept a Japanese or romaji keyword and an optional page number, making it straightforward to paginate through search results ranked by Rakuten's default relevance algorithm.
What the API Returns
The search_products endpoint queries Rakuten Ichiba and returns a paginated list of matching products. Each response includes the page number returned, a count of items on that page, and an items array. Every item in that array carries six fields: name (product title), url (direct link to the listing), price (listed price), shop_id (the merchant identifier), item_id (Rakuten's unique item identifier), and is_furusato_nozei (a boolean flag indicating whether the item is eligible for Japan's Furusato Nozei — Hometown Tax — program based on its title). The response also echoes back the query string you submitted.
Using the Endpoint
The only required input is query, a search keyword string. Japanese characters work as expected — for example, テレビ for televisions or コーヒー for coffee. The optional page parameter must be a positive integer and lets you walk through result pages. Results follow Rakuten's default relevance ranking; there is no sort parameter exposed by this endpoint.
Furusato Nozei Detection
The is_furusato_nozei flag is derived from each product's title. Rakuten Ichiba hosts a large number of tax-donation-eligible items through the Furusato Nozei scheme, and this field lets you filter or segment those products without parsing product titles yourself. Keep in mind the flag is title-based, so edge cases with ambiguous naming may affect accuracy.
- Track price changes for specific product keywords across Rakuten Ichiba by polling
search_productsover time. - Build a Furusato Nozei gift catalog by filtering results where
is_furusato_nozeiis true. - Identify which
shop_idvalues dominate search results for a given category keyword. - Aggregate
item_idandurlpairs to build a link directory of Rakuten listings for a niche product segment. - Compare listing counts (
count) across different keyword variants to gauge relative product availability. - Feed product names and prices into a price-comparison tool covering Japanese marketplace inventory.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Rakuten have an official developer API?+
What does the `is_furusato_nozei` field actually indicate?+
name field. It is not a guarantee of eligibility — it reflects what is present in the title text of each listing.Does the API return product reviews, ratings, or review counts?+
search_products endpoint returns name, url, price, shop_id, item_id, and is_furusato_nozei — no review scores or counts are included. You can fork this API on Parse and revise it to add a review-data endpoint if that data is part of what you need.Can I filter results by price range or product category?+
query and page are currently exposed. Results follow Rakuten's default relevance ranking for the given keyword. You can fork this API on Parse and revise it to add category or price-range filter inputs to the endpoint.