API-Referenz

Einführung

Die AliExpress Reviews API liefert AliExpress-Produktbewertungen als JSON. Es ist ein einziger REST-Endpoint über HTTPS; jede Antwort, auch Fehler, ist JSON.

Basis-URL

https://api.aliexpress-reviews.com

Auth

Header x-api-key

Format

JSON, UTF-8

Schnellstart: kostenlosen Key erstellen, dann im API-Tester des Dashboards ausprobieren oder ausführen:

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

Authentifizierung

Erstelle im Dashboard einen API-Key und sende ihn im Header x-api-key jeder Anfrage. Keys beginnen mit rv_.

Der Key wird nur einmal angezeigt, nämlich beim Erstellen: Wir speichern einen Hash, nicht den Key. Wenn du ihn verlierst, erneuere ihn im Dashboard; der alte Key funktioniert dann innerhalb von 5 Minuten nicht mehr.

Bewahre den Key nur serverseitig auf. Jeder, der ihn hat, kann dein Kontingent verbrauchen.

GET /v1/reviews/{productId}

Liefert eine Seite mit Bewertungen eines Produkts sowie eine Übersicht seiner Bewertungen.

Pfadparameter

Query-Parameter

Unbekannte Parameter liefern 400. Ein Parameter, der nicht in deinem Plan enthalten ist, liefert 403, auch wenn sein Wert dem Standard entspricht.

Beispielanfrage

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

Filter

Die Filter sind dieselben, die AliExpress auf der Produktseite zeigt, und AliExpress wendet sie an. Sende pro Anfrage einen filter; sie lassen sich nicht kombinieren.

summary.filterCounts in der Antwort zeigt dir, wie viele Bewertungen jeder Filter liefern würde, sodass du leere Filter in deiner UI ohne zusätzliche Anfragen ausblenden kannst.

Sprachen

Mit lang (Pro) werden content und additionalFeedback von AliExpress übersetzt. originalContent behält immer die Worte des Käufers.

Antwort

{
  "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://..."]
    }
  ]
}

Seitenfelder

Bewertungsfelder

images und thumbnails entfallen bei Free und Pro.

Paginierung

Rufe page=1, 2, … ab, bis page den Wert totalPages erreicht. Jede Seite zählt als eine Anfrage auf dein Kontingent, nutze also die größte pageSize, die dein Plan erlaubt.

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

Kontingente werden um 00:00 UTC zurückgesetzt. Jede Antwort, die aufs Kontingent zählt (200, 404, 429, 502), enthält:

Mit 400/401/403 abgelehnte Anfragen zählen nicht. Bei überschrittenem Kontingent erhältst du bis zum Reset 429. Zusätzlich gilt ein globales Limit von 50 Anfragen pro Sekunde, das sich alle Nutzer teilen.

Caching

Jede Seite (Produkt + Parameter) wird bis zu 24 Stunden zwischengespeichert, daher kann es bis zu einen Tag dauern, bis neue Bewertungen erscheinen. Gecachte Antworten zählen trotzdem auf dein Kontingent.

Fehler

Fehler verwenden Standard-HTTP-Statuscodes und einen JSON-Body:

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

OpenAPI

Die vollständige Spezifikation findest du unter /openapi.json (OpenAPI 3.0). Importiere sie in Postman, Insomnia oder einen Client-Generator.