# Mercado Libre Reviews API Documentation

Returns buyer reviews with rating, text, relative date label, exact creation time, country, variant, helpful count and photos in several sizes. Set id_type to item for an item id (MLA3965765480) or product for a catalogue product id (MLA79197996). A wrong pairing returns an empty list. Page with limit (1 to 30) and offset; next_offset is set when a full page came back. Filter by rating 1 to 5 and order by relevance or date. Failed requests (404, 422, 503) are never billed. A valid answer with zero rows is a successful, billable 200.

- **Documentation:** [https://scrappa.co/docs/mercadolibre-api/mercadolibre_reviews](https://scrappa.co/docs/mercadolibre-api/mercadolibre_reviews)
- **API group:** Mercado Libre API
- **Endpoint:** `GET https://scrappa.co/api/mercadolibre/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 |
| --- | --- | --- | --- |
| `site` | string | Yes | Country site id: MLA (Argentina), MLB (Brazil), MLM (Mexico), MLC (Chile), MCO (Colombia), MPE (Peru), MLU (Uruguay), MEC (Ecuador) or MLV (Venezuela). |
| `id` | string | Yes | Item id or catalogue product id. |
| `id_type` | string | No | item or product. Defaults to item. |
| `limit` | integer | No | Reviews per page, 1 to 30. Defaults to 10. |
| `offset` | integer | No | Reviews to skip. Defaults to 0. |
| `rating` | integer | No | Only reviews with this star rating, 1 to 5. |
| `order` | string | No | relevance or date. Defaults to relevance. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/mercadolibre/reviews?site=MLA&id=MLA3965765480&id_type=item&limit=3"
```

## Example response

```json
{
    "success": true,
    "data": {
        "id": "MLA3965765480",
        "id_type": "item",
        "reviews": [
            {
                "id": 2864327641,
                "rating": 5,
                "text": "Muy lindo y suave lo confirma el rey de la casa.",
                "date_label": "Hace 5 meses",
                "created_at": "2026-04-27T18:12:19Z",
                "helpful_count": 53,
                "media": [
                    {
                        "id": "944826-MLA110042123238_042026",
                        "type": "photo",
                        "sizes": [
                            {
                                "size": "501x377",
                                "url": "https://http2.mlstatic.com/D_NQ_NP_944826-MLA110042123238_042026-O.jpg"
                            }
                        ]
                    }
                ]
            }
        ],
        "count": 3,
        "offset": 0,
        "limit": 3,
        "next_offset": 3
    },
    "meta": {
        "endpoint_family": "reviews",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The item, category or store does not exist on this site. This response is not billable. |
| 422 | Validation Error | A parameter is invalid: unknown site, an id that does not belong to the site, a limit out of range, rating other than 1 to 5, or a zip code of another country. This response is not billable. |
| 503 | Service Unavailable | The service could not obtain a complete result from Mercado Libre. 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)