# Flipkart Reviews API Documentation

<p><strong>Flipkart Reviews API Documentation</strong> Read the customer reviews of one Flipkart product. Each review has rating, title, text, author, certified buyer flag, helpful count, location, photos and the age as Flipkart shows it. The list shows relative ages, so created_at is an estimate and created_at_precision says how exact it is (day, week, month or year). The total is the number of reviews of the product. Flipkart serves at most the first 100 reviews of one sort order; the star filter and the certified buyer filter are not available. Cost: 1 credit per request, only for successful requests. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/flipkart-api/flipkart_reviews](https://scrappa.co/docs/flipkart-api/flipkart_reviews)
- **API group:** Flipkart API
- **Endpoint:** `GET https://scrappa.co/api/flipkart/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 |
| --- | --- | --- | --- |
| `pid` | string | No | Flipkart product id as the search returns it in id, for example MOBHQV9YDG7CGRAM. Send pid or url. |
| `url` | string | No | Flipkart product page url. Scrappa reads the pid from it. Send pid or url. |
| `sort` | string | No | MOST_RECENT (default), MOST_HELPFUL, POSITIVE_FIRST or NEGATIVE_FIRST. |
| `page` | integer | No | Page number, 1 or higher. Flipkart serves at most 100 reviews for one sort order, so page times per_page is at most 100. A deeper page returns 422. |
| `per_page` | integer | No | Reviews per page, 1 to 30. Default 10. |

## Example response

```json
{
    "data": {
        "id": "MOBHQV9YDG7CGRAM",
        "sort": "MOST_RECENT",
        "items": [
            {
                "id": "cf86afa8-5e71-48de-b41c-50ecf822cbc0",
                "url": "https://www.flipkart.com/reviews/MOBHFN6YTSH3QRCZ:758?reviewId=cf86afa8-5e71-48de-b41c-50ecf822cbc0",
                "text": "Good",
                "title": "Great product",
                "author": "MOHAMMED JASEEM K",
                "images": [],
                "rating": 5,
                "created": "11 days ago",
                "location": null,
                "created_at": "2026-10-28",
                "helpful_count": 0,
                "certified_buyer": true,
                "created_at_precision": "day"
            },
            {
                "id": "f2116910-e008-4896-ace3-1b0f83ee3cd7",
                "url": "https://www.flipkart.com/reviews/MOBHQV9YAZYYWY8A:380?reviewId=f2116910-e008-4896-ace3-1b0f83ee3cd7",
                "text": "Nice",
                "title": "Good choice",
                "author": "AVISHEK KUMAR  Jha",
                "images": [],
                "rating": 4,
                "created": "Sep, 2025",
                "location": null,
                "created_at": "2025-09",
                "helpful_count": 1,
                "certified_buyer": true,
                "created_at_precision": "month"
            }
        ],
        "pagination": {
            "total": 3111,
            "has_more": true,
            "per_page": 10,
            "reachable": 100,
            "current_page": 1
        }
    },
    "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 | Flipkart has no product with this id. This response is not billable. |
| 503 | Upstream Unavailable | Flipkart did not answer or sent data Scrappa cannot read. This response is not billable. Retry later. |

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