Rakuten marketplace product data, including seller offers. Delivered via partner data feeds in kwery's standard normalized shape.
Rolling out. Rakuten is onboarding now and is not yet enabled by default on new accounts. Contact us to be enabled as it goes live — the API shape documented on this page is final and will not change.
country accepts: jp
Rakuten is served from the Japan marketplace (rakuten.co.jp). Prices are in JPY.
| Key | Values | Description |
|---|---|---|
term | Free text | Keyword search. |
id | Rakuten item ID | Direct product lookup. |
| Topic | Description |
|---|---|
search (default) | Product page, including the lead offer. |
search_and_offers | Also fetches the full seller-offer list. |
Returns the standard normalized content object (see Sources overview): name, url, currency, price_min / price_avg / price_max, offers_count, offers[], review_rating / review_count. With topic: search_and_offers, offers[] lists each seller's name, price, currency, and shipping.
curl -s https://api.kwery.co/job \
-H "Authorization: Bearer $KWERY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"source":"rakuten","country":"jp","key":"term","topic":"search_and_offers","values":["Nintendo Switch"]}'Results are fetched with GET /job/{id}/download once the job is finished — each entry is the result for one input value (abridged):
[
{
"key": "Nintendo Switch",
"success": true,
"reason": null,
"content": {
"name": "Nintendo Switch",
"url": "https://item.rakuten.co.jp/example-shop/1234567890/",
"currency": "JPY",
"price_min": 29800,
"price_avg": 30500,
"price_max": 31200,
"offers_count": 2,
"offers": [
{ "shop_name": "game-shop-tokyo", "price": 29800, "currency": "JPY", "shipping": 0 },
{ "shop_name": "denki-mart", "price": 31200, "currency": "JPY", "shipping": 550 }
],
"review_rating": 4.6,
"review_count": 1840
}
}
]