# Tokopedia Reviews API Documentation

<p><strong>Tokopedia Reviews API</strong> returns a product rating summary, star buckets, topics and a list of written reviews with numeric rating, ISO 8601 date, full-size images and reviewer name.</p><p>Send the product id from search unchanged. Page N returns the real page N.</p><p>Costs 1 credit per successful request. Empty results and failed requests are free.</p>

- **Documentation:** [https://scrappa.co/docs/tokopedia-api/tokopedia_reviews](https://scrappa.co/docs/tokopedia-api/tokopedia_reviews)
- **API group:** Tokopedia API
- **Endpoint:** `GET https://scrappa.co/api/tokopedia/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 |
| --- | --- | --- | --- |
| `product_id` | string | Yes | Product id from search. |
| `page` | integer | No | One-based page number (default 1). |

## Example response

```json
{
    "data": {
        "topics": [
            {
                "name": "Kualitas Barang",
                "count": 1
            }
        ],
        "reviews": [
            {
                "id": "1105811911",
                "date": "2024-10-14T12:30:06Z",
                "text": "sepatu ringan, nyaman",
                "user": "Vinaya",
                "likes": 3,
                "images": [
                    "https://images.tokopedia.net/review.jpg"
                ],
                "rating": 5,
                "variant": "36",
                "seller_reply": null
            }
        ],
        "summary": {
            "total": 2,
            "average": 5,
            "buckets": [
                {
                    "count": 2,
                    "rating": 5,
                    "percentage": 100
                }
            ],
            "with_image": 2
        },
        "pagination": {
            "page": 1,
            "has_next": false
        },
        "product_id": "13499832987"
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "reviews"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a value is invalid. This response is not billable. |
| 503 | Upstream Unavailable | The source could not be reached. This response is not billable. Retry shortly. |

## 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)
