# AliExpress Reviews API (https://www.socialcrawl.dev/platforms/aliexpress/reviews)

> Returns written customer reviews for an AliExpress product, 20 per page, each with text, translated text when present, star rating, reviewer name, country, date, and photo URLs. A product with no reviews comes back empty and is not billed. Optional filter: all, 1-5 (star), image, additional, local. Optional sort_by: default or newest. Pair filter=local with country to keep reviews from that country.

TL;DR: `GET /v1/aliexpress/reviews` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `product_id` | no | AliExpress product id, the numeric id in a product URL: aliexpress.com/item/3256812847028710.html is product id 3256812847028710. Product ids also come back on every row of GET /v1/aliexpress/search and GET /v1/aliexpress/search/hot. |
| `url` | no | Full AliExpress product URL, for example https://www.aliexpress.com/item/3256812847028710.html. The product id is extracted from the path. |
| `page` | no | Page number, starting at 1. Prefer the universal cursor parameter. |
| `filter` | no | Keep all reviews, only one star value (1-5), only reviews with photos (image), additional comments, or local reviews for country. (all \| 1 \| 2 \| 3 \| 4 \| 5 \| image \| additional \| local) |
| `sort_by` | no | Review ordering: default or newest. (default \| newest) |
| `country` | no | Reviewer country when filter=local. Default US. |
| `language` | no | Copy language as an ISO code. Default EN. Live-validated: EN RU PT ES FR ID IT TH JA AR VI TR DE HE KO NL PL MX CL IN. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/aliexpress/reviews" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

See the full AliExpress API: https://www.socialcrawl.dev/platforms/aliexpress

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing