# Tiki Reviews API Documentation

<p><strong>Tiki Reviews API</strong> lists the public reviews of a Tiki product, 5 per page. Each review has the id, rating, title, text, thank count, ISO 8601 date and any images. The summary has the average rating, review count, star counts and attribute vote summary.</p><p>Send the <code>id</code> from search. The optional <code>spid</code> and <code>seller_id</code> come from search unchanged. Page N returns the real page N. Review author display names are stripped because they are personal data.</p><p>Costs 1 credit per successful request. Empty results and failed requests are free.</p>

- **Documentation:** [https://scrappa.co/docs/tiki-api/tiki_reviews](https://scrappa.co/docs/tiki-api/tiki_reviews)
- **API group:** Tiki API
- **Endpoint:** `GET https://scrappa.co/api/tiki/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` | integer | Yes | Product id from search (required), for example 278628812. |
| `page` | integer | No | One-based page number (default 1). 5 reviews per page. |
| `spid` | integer | No | Seller product id from search (optional). |
| `seller_id` | integer | No | Seller id from search (optional). |

## Example response

```json
{
    "data": {
        "reviews": [
            {
                "id": "99001",
                "title": "Good phone",
                "images": [],
                "rating": 5,
                "seller": null,
                "content": "Fast delivery and good quality.",
                "sku_info": "Color: Black",
                "created_at": "2026-11-18T09:30:00Z",
                "thank_count": 3
            }
        ],
        "summary": {
            "stars": {
                "1": 3,
                "2": 5,
                "3": 15,
                "4": 40,
                "5": 150
            },
            "review_count": 213,
            "rating_average": 4.8,
            "attribute_vote_summary": []
        },
        "currency": "VND",
        "pagination": {
            "page": 1,
            "has_next": true,
            "per_page": 5,
            "total_pages": 43,
            "total_reviews": 213
        },
        "product_id": "278628812"
    },
    "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 | Tiki could not be reached. This response is not billable. |

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