# AliExpress Reviews

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/aliexpress/product/reviews` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/aliexpress-product-reviews |

## Description

AliExpress Reviews API: list buyer reviews for a product id or item URL. Each review includes author, star rating, text, date, and photos when the buyer attached them.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/aliexpress/product/reviews' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Buyer review for product 1005001388303149

```json
{
  "results": [
    {
      "date": "27 Feb 2026",
      "text": "очень понравился ребенку! пришел быстрее, чем ожидали, все работает, не очень шумный. рекомендую👍",
      "author": "Б***а",
      "images": [
        "https://ae-pic-a1.aliexpress-media.com/kf/A23a05703ab0b4c5ea4a69b008c4da67fw.jpg"
      ],
      "rating": 5
    }
  ],
  "pagination": {
    "next": "https://feedback.aliexpress.com/pc/searchEvaluation.do?productId=1005001388303149&lang=en_US&country=US&page=2&pageSize=20&filter=all&sort=complex_default",
    "page": 1,
    "per_page": 20,
    "total_pages": 2,
    "total_results": 26
  }
}
```

## Documentation

## Overview
The **AliExpress Reviews API** lists buyer reviews for one product. Pass a numeric product id or an AliExpress item URL.

## Quickstart
```
GET https://api.piloterr.com/v2/aliexpress/product/reviews?query=1005001388303149
```

```
GET https://api.piloterr.com/v2/aliexpress/product/reviews?query=https://www.aliexpress.com/item/1005001388303149.html&page=1
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Product id or AliExpress item URL |
| `page` | integer | no | Page number, starting at 1 (default 1) |
| `return_page_source` | boolean | no | Raw feed as `{"result": "..."}` |

## Response fields
`author`, `rating` (1 to 5), `text`, `date`, and `images` when the buyer attached photos. `pagination.next` is the next URL or null.

## Error codes
| Code | Meaning |
|---|---|
| 400 | Missing query, invalid page, or a URL that is not an AliExpress product |
| 404 | Feed missing or not parseable |
| 500 | Fetch error |