# Takealot Reviews API Documentation

Returns ten public reviews per page for one PLID. Each row keeps the rating, text, ISO 8601 date, helpful count, TSIN id and variant info. Reviewer names, customer ids and signatures are removed. Page numbers start at zero. Sort by most helpful or latest and filter by star rating. Failed requests (404, 422, 503) are never billed. A valid answer with zero rows is a successful, billable 200.

- **Documentation:** [https://scrappa.co/docs/takealot-api/takealot_reviews](https://scrappa.co/docs/takealot-api/takealot_reviews)
- **API group:** Takealot API
- **Endpoint:** `GET https://scrappa.co/api/takealot/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 | Yes | Numeric PLID from search, for example 94928735. |
| `page` | integer | No | Zero-based page number. Defaults to 0. |
| `sort` | string | No | SO_MOST_HELPFUL or SO_LATEST. |
| `rating` | integer | No | Only reviews with this star rating, 1 to 5. |
| `colour_variant` | string | No | Only reviews of this colour variant. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/takealot/reviews?id=94928735&page=0"
```

## Example response

```json
{
    "success": true,
    "data": {
        "id": "94928735",
        "reviews": [
            {
                "rating": 5,
                "text": "Good value for money.",
                "date": "2026-04-27T18:12:19Z",
                "upvotes": 53,
                "tsin_id": "95760710"
            }
        ],
        "count": 1,
        "total": 156,
        "total_pages": 16,
        "page": 0,
        "page_size": 10
    },
    "meta": {
        "endpoint_family": "reviews",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The requested Takealot record was not found. This response is not billable. |
| 422 | Validation Error | A parameter is invalid: a bad PLID, an unknown sort, a malformed facet or a price band out of range. This response is not billable. |
| 503 | Service Unavailable | The service could not obtain a complete result. 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)
