# Rakuten Reviews API Documentation

<p><strong>Rakuten Reviews API Documentation</strong> Read the reviews of a Rakuten Ichiba item. Each review has the star rating, title, text, nickname, the review date and order date as ISO 8601 dates, helpful votes, the reviewer sex and age group, the purchase purposes, the bought variant, photos and the reply of the shop. The response also has the review score of the item and of the shop with the count per star, so one call gives both ratings. Sort by helpful votes, rating or newest, filter by star rating, or return only reviews with photos. Every returned review matches your filter. Rakuten lists up to 100 pages of 30 reviews per item. Dates are calendar days in Japan time. Cost: 1 credit per request. An empty page, an unknown item and failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/rakuten-api/rakuten_reviews](https://scrappa.co/docs/rakuten-api/rakuten_reviews)
- **API group:** Rakuten API
- **Endpoint:** `GET https://scrappa.co/api/rakuten/reviews`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | No | Item id from a search, item or ranking result, e.g. 386567_10000118. Send the id, or send shop_id and item_id. |
| `shop_id` | integer | No | Numeric shop id, e.g. 386567. Send it with item_id when you have no id. |
| `item_id` | integer | No | Numeric item id, e.g. 10000118. Send it with shop_id when you have no id. |
| `page` | integer | No | Page number from 1 to 100. Each page has 30 reviews. A page beyond the last returns an empty list. |
| `sort` | string | No | Sort order: standard (default), helpful (most votes first), rating (highest first) or newest. |
| `rating` | integer | No | Only reviews with this star rating, 1 to 5. total_results is the number of matching reviews. |
| `media_only` | boolean | No | Set to true to return only reviews with photos. |

## Example response

```json
{
    "data": {
        "item": {
            "id": "386567_10000118",
            "url": "https://item.rakuten.co.jp/cicibella-sports/msk50-5/",
            "name": "\u9ad8\u8a55\u4fa1\uff3c\u5e74\u9593\u30e9\u30f3\u30ad\u30f3\u30b01\u4f4d\u53d7\u8cde\uff0f \u30de\u30b9\u30af \u30d0\u30a4\u30ab\u30e9\u30fc\u30de\u30b9\u30af \u4e0d\u7e54\u5e03\u30de\u30b9\u30af \u5927\u5bb9\u91cf51\u679a \u7acb\u4f53\u30de\u30b9\u30af ",
            "rating": {
                "count": 168198,
                "average": 4.51,
                "distribution": {
                    "1": 2933,
                    "2": 2927,
                    "3": 9430,
                    "4": 42490,
                    "5": 110418
                }
            }
        },
        "shop": {
            "id": 386567,
            "url": "https://www.rakuten.co.jp/cicibella-sports",
            "name": "cicibella sports",
            "rating": {
                "count": 115334,
                "average": 4.67,
                "distribution": {
                    "1": 2665,
                    "2": 1528,
                    "3": 6847,
                    "4": 23625,
                    "5": 80660
                }
            }
        },
        "filters": [],
        "reviews": [
            {
                "id": "b00fe5e6-438f-4216-8cae-070cd3847cbf",
                "body": "\u767d\u306e\u30de\u30b9\u30af\u304c\u6e05\u6f54\u611f\u304c\u3042\u3063\u3066\u4e00\u756a\u597d\u304d\u3067\u3059\u3002\u5bb6\u65cf\u307f\u3093\u306a\u3067\u9577\u5e74\u3064\u304b\u3063\u3066\u3044\u307e\u3059\u3002\u30b4\u30e0\u306e\u90e8\u5206\u306e\u6750\u8cea\u304c\u67d4\u3089\u304b\u304f\u3066\u9577\u6642\u9593\u4f7f\u3063\u3066\u3044\u3066\u3082\u8033\u304c\u75db\u304f\u306a\u308a\u306b\u304f\u3044\u3067\u3059\u3002\u808c\u306b\u5f53\u305f\u308b\u90e8\u5206\u3082\u67d4",
                "media": [
                    {
                        "url": "https://image.space.rakuten.co.jp/d/strg/ctrl/8/077aa1f62be31d2d4fd4c6514a767ec017388fef.62.9.8.3.png",
                        "thumbnail_url": "https://image.space.rakuten.co.jp/d/strg/ctrl/8/077aa1f62be31d2d4fd4c6514a767ec017388fef.62.9.8.3.png?thum=120"
                    }
                ],
                "title": "\u4e0d\u7e54\u5e03\u30de\u30b9\u30af\u3002",
                "rating": 5,
                "variant": "\u30b5\u30a4\u30ba:\u30d7\u30ea\u30fc\u30c4\u30de\u30b9\u30af(\u666e\u901a\u30b5\u30a4\u30ba)51\u679a | \u30ab\u30e9\u30fc:\u30109\u3011\u30db\u30ef\u30a4\u30c8",
                "nickname": "Mayu & You\u3055\u3093",
                "purposes": [
                    "\u5bb6\u65cf\u3078",
                    "\u5b9f\u7528\u54c1\u30fb\u666e\u6bb5\u4f7f\u3044",
                    "\u30ea\u30d4\u30fc\u30c8"
                ],
                "reviewer": {
                    "sex": "female",
                    "age_range": 50
                },
                "posted_on": "2026-04-28",
                "ordered_on": "2025-12-20",
                "shop_reply": {
                    "text": "\u3053\u306e\u5ea6\u306f\u5f53\u5e97\u3092\u3054\u5229\u7528\u3044\u305f\u3060\u304d\u8aa0\u306b\u3042\u308a\u304c\u3068\u3046\u3054\u3056\u3044\u307e\u3059\u3002\n\n\u3053",
                    "replied_on": "2026-05-21"
                },
                "helpful_count": 0
            }
        ],
        "pagination": {
            "page": 1,
            "has_next": true,
            "page_size": 30,
            "total_results": 168198
        }
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "reviews"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | Rakuten has no item with this id. Send the id from a search, item or ranking result. This response is not billable. |
| 503 | Upstream Unavailable | Rakuten did not answer after the internal retries. This response is not billable. Retry after a few seconds. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)