API reference

Introduction

The AliExpress Reviews API returns AliExpress product reviews as JSON. It is a single REST endpoint over HTTPS; every response, errors included, is JSON.

Base URL

https://api.aliexpress-reviews.com

Auth

x-api-key header

Format

JSON, UTF-8

Quickstart: create a free key, then try it in the dashboard’s API tester or run:

curl "https://api.aliexpress-reviews.com/v1/reviews/1005006123456789?filter=5&pageSize=20" \
  -H "x-api-key: $REVIEWS_API_KEY"

Authentication

Create an API key in the dashboard and send it in the x-api-key header of every request. Keys start with rv_.

The key is shown only once, when you create it: we store a hash, not the key. If you lose it, rotate it from the dashboard; the old key stops working within 5 minutes.

Keep the key server-side. Anyone who has it can spend your quota.

GET /v1/reviews/{productId}

Returns one page of reviews of a product, plus a summary of its ratings.

Path parameters

Query parameters

Unknown parameters return 400. A parameter your plan doesn’t include returns 403, even if its value is the default.

Example request

curl "https://api.aliexpress-reviews.com/v1/reviews/1005006123456789?filter=5&pageSize=20" \
  -H "x-api-key: $REVIEWS_API_KEY"

const url = new URL('https://api.aliexpress-reviews.com/v1/reviews/1005006123456789');
url.search = new URLSearchParams({ filter: '5', pageSize: '20' }).toString();

const res = await fetch(url, { headers: { 'x-api-key': process.env.REVIEWS_API_KEY } });
if (!res.ok) throw new Error((await res.json()).error.message);
const { summary, data } = await res.json();

import os, requests

res = requests.get(
    "https://api.aliexpress-reviews.com/v1/reviews/1005006123456789",
    params={"filter": "5", "pageSize": 20},
    headers={"x-api-key": os.environ["REVIEWS_API_KEY"]},
)
res.raise_for_status()
body = res.json()

Filters

Filters are the same ones AliExpress shows on the product page, and AliExpress applies them. Send one filter per request; they can’t be combined.

The response’s summary.filterCounts tells you how many reviews each filter would return, so you can hide empty filters in your UI without extra requests.

Languages

With lang (Pro), content and additionalFeedback come translated by AliExpress. originalContent always keeps the buyer’s own words.

Response

{
  "productId": "1005006123456789",
  "filter": "all",
  "page": 1,
  "pageSize": 20,
  "total": 452,
  "totalPages": 23,
  "summary": {
    "averageRating": 4.4,
    "totalReviews": 452,
    "ratingDistribution": { "5": 323, "4": 54, "3": 33, "2": 12, "1": 30 },
    "filterCounts": { "all": 452, "image": 32, "additional": 6, "local": 63 }
  },
  "data": [
    {
      "id": "60012345678901234",
      "author": "J***n",
      "country": "ES",
      "rating": 5,
      "content": "Very good quality, arrived in 10 days",
      "originalContent": "Muy buena calidad, llegó en 10 días",
      "additionalFeedback": null,
      "date": "2026-08-09",
      "sku": "Color:Black",
      "helpfulVotes": 3,
      "images": ["https://..."],
      "thumbnails": ["https://..."]
    }
  ]
}

Page fields

Review fields

images and thumbnails are omitted on Free and Pro.

Pagination

Request page=1, 2, … until page reaches totalPages. Each page is one request against your quota, so use the largest pageSize your plan allows.

async function allReviews(productId, filter = 'all') {
  const reviews = [];
  for (let page = 1; ; page++) {
    const url = `https://api.aliexpress-reviews.com/v1/reviews/${productId}?filter=${filter}&page=${page}`;
    const res = await fetch(url, { headers: { 'x-api-key': process.env.REVIEWS_API_KEY } });
    const body = await res.json();
    reviews.push(...body.data);
    if (page >= body.totalPages) return reviews;
  }
}

Rate limits

Quotas reset at 00:00 UTC. Every response that counts against the quota (200, 404, 429, 502) carries:

Requests rejected with 400/401/403 don’t count. Over the quota you get 429 until the reset. There is also a global limit of 50 requests per second shared by all users.

Caching

Each page (product + parameters) is cached for up to 24 hours, so new reviews can take up to a day to show up. Cached responses still count against your quota.

Errors

Errors use standard HTTP status codes and a JSON body:

{ "error": { "message": "filter=image requires the MAX plan" } }

OpenAPI

The full spec is at /openapi.json (OpenAPI 3.0). Import it into Postman, Insomnia or a client generator.