API AliExpress

AliExpress Отзывы API

Get one page of buyer reviews for an AliExpress product by id, with rating, text, buyer country, date, bought variant and photos for each review, plus the product's total reviews, average rating and star distribution, in one normalized response.

POST/v1/run/aliexpress.reviews
Доступность
100,00%
30d · 1 вызов
Запросы
1
30d
Ответ
2,0s
медиана · 30d

Цены и поставщики

Цена API AliExpress Отзывы: один API, поставщиков 2, и любой может заменить другого

Первым обслуживает самый дешёвый поставщик. Если он не отвечает, его заменяет следующий в том же вызове.

Вы платите
8,50 USD
0,85 USD/1 тыс. запросов, только за то, чем пользуетесь. Без ежемесячного тарифа.
Ваши первые запросы (117) бесплатны за счёт стартового баланса 0,10 USD.

Попробовать

Получите AliExpress Отзывы одним запросом

requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `helpfulVotes`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. Naming a combination that no single source returns together is refused as invalid input, with no charge.
Открыть в
Пример ответа
Бесплатные запуски возвращают только первые результаты: 3. Пополните ключ, чтобы получить полный ответ.
{
  "data": {
    "items": [
      {
        "aspects": [
          {
            "name": "Example title",
            "value": "19.99"
          }
        ],
        "country": "US",
        "createdUtc": 12.5,
        "followUpImages": [
          "https://example.com/image.jpg"
        ],
        "followUpText": "A short example description of this item.",
        "followUpUtc": 12.5,
        "helpfulVotes": 42,
        "images": [
          "https://example.com/image.jpg"
        ],
        "rating": 4.6,
        "reviewId": "A short example description of this item.",
        "reviewer": "A short example description of this item.",
        "shippingMethod": "example",
        "skuInfo": "a1b2c3d4",
        "text": "A short example description of this item.",
        "unhelpfulVotes": 42
      }
    ],
    "rating": 4.6,
    "ratingDistribution": {
      "1": 42,
      "2": 42,
      "3": 42,
      "4": 42,
      "5": 42
    },
    "totalPages": 12500,
    "totalReviews": 12500
  },
  "found": true,
  "reason": "not_found"
}

Полный справочник по параметрам и ответу: каждое поле, тип и пример для этого эндпоинта.

Справочник

Один запрос, один формат ответа.

Каждое поле, которое вы отправляете, и каждое поле, которое получаете, с реальным примером.

Проверено 2026-10-23 · доступность и задержка измерены за 30d

Тело запроса

JSON, отправляется на этот эндпоинт.

  • productIdstring

    3256807039224587

    AliExpress product id, the number in the product URL (https://www.aliexpress.com/item/<id>.html), e.g. 3256807039224587. The AliExpress Search SKU returns it as productId.

  • pageinteger

    1-based page of 20 reviews in AliExpress's default order. Each page is billed as one request.

  • requireFieldsarray

    Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `helpfulVotes`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. Naming a combination that no single source returns together is refused as invalid input, with no charge.

Вы отправляете. Небольшое тело JSON. Показанные значения это примеры, замените их своими.

Ответ

JSON, по одному примеру значения на поле.

each aspectdata.items[].aspects[]

The buyer's ratings of named aspects of the product, e.g. {"name": "Durability", "value": "Poor"}; empty when the buyer rated none.

  • namestring

    Aspect the buyer rated, e.g. "Durability".

  • valuestring

    The buyer's rating of it, e.g. "Poor", or null when not reported.

each itemdata.items[]

Buyer review records for the requested page. Populated whenever the provider has data for the entity.

  • countrystring

    2-letter ISO code of the buyer's country, e.g. "US", or null when not reported. Populated whenever the provider has data for the entity.

  • createdUtcnumber

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. AliExpress publishes the review date only, so this is midnight UTC of that date; null when not reported. Populated whenever the provider has data for the entity.

  • followUpImagesstring[]может потребовать

    Photo URLs attached to the follow-up review; empty when it has none, null when the serving source does not report follow-ups.

  • followUpTextstringможет потребовать

    Text of the follow-up review the buyer added later, or null when there is none or the serving source does not report it.

  • followUpUtcnumberможет потребовать

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. The day the buyer added the follow-up review, as midnight UTC of that date; null when there is none or the serving source does not report it.

  • helpfulVotesintegerможет потребовать

    Number of "helpful" votes the review received, or null when the serving source does not report it.

  • imagesstring[]

    Photo URLs the buyer attached; empty when there are none. Populated whenever the provider has data for the entity.

  • ratingnumber

    Star rating the buyer gave, 1-5.

  • reviewIdstring

    AliExpress review id; use it to deduplicate across pages. Populated whenever the provider has data for the entity.

  • reviewerstring

    Buyer display name as AliExpress shows it, usually masked (e.g. "A***r") or "AliExpress Shopper". Populated whenever the provider has data for the entity.

  • shippingMethodstring

    Shipping service the buyer's order came by, as AliExpress names it, e.g. "AliExpress Selection Standard Shipping", or null when not reported. Populated whenever the provider has data for the entity.

  • skuInfostring

    The variant the buyer bought, as AliExpress prints it, e.g. "Color:Yellow Size:XXL", or null when not reported. Populated whenever the provider has data for the entity.

  • textstring

    Review body text in the buyer's own language; empty when the buyer left a rating only. Populated whenever the provider has data for the entity.

  • unhelpfulVotesintegerможет потребовать

    Number of "not helpful" votes the review received, or null when the serving source does not report it.

datadata

Reviews wrapper, or null when the product returned no reviews on this page.

  • ratingnumber

    Overall product score (1-5), or null when not reported. Populated whenever the provider has data for the entity.

  • totalPagesinteger

    Number of 20-review pages AliExpress reports for the product, or null when not reported.

  • totalReviewsinteger

    Total number of reviews for the product, or null when not reported. Populated whenever the provider has data for the entity.

ratingDistributiondata.ratingDistribution

Number of reviews at each star rating, keyed "1" through "5". Populated whenever the provider has data for the entity.

  • 1integer

    Number of 1-star reviews.

  • 2integer

    Number of 2-star reviews.

  • 3integer

    Number of 3-star reviews.

  • 4integer

    Number of 4-star reviews.

  • 5integer

    Number of 5-star reviews.

top level
  • foundboolean

    True when at least one review was returned.

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

Вы получаете. Именованные типизированные поля в одном формате, какой бы источник ни ответил.

Вопросы и ответы

Об API AliExpress Отзывы

AnyAPI AliExpress Отзывы API возвращает данные AliExpress в виде нормализованного JSON одним вызовом POST к /v1/run/aliexpress.reviews. Get one page of buyer reviews for an AliExpress product by id, with rating, text, buyer country, date, bought variant and photos for each review, plus the product's total reviews, average rating and star distribution, in one normalized response. AnyAPI направляет каждый запрос по источникам (их 2) и автоматически переключается, если один из них отказывает. Это стоит от 0,85 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума. За последние 30 дней 100,0% вызовов AliExpress Отзывы через AnyAPI завершились успешно, медианное время ответа 2,0 с, измерено вызовов: 1.

Это стоит от 0,85 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума. Вы пополняете один кошелёк в долларах США, и каждый вызов списывает с него. По некоторым неудавшимся запросам, оплаченным из кошелька, возникают расходы на обработку; мы передаём их по себестоимости, без наценки, а сумма списания указана в ответе с ошибкой.

Get one page of buyer reviews for an AliExpress product by id, with rating, text, buyer country, date, bought variant and photos for each review, plus the product's total reviews, average rating and star distribution, in one normalized response. Ответ это нормализованный JSON с тем же конвертом, что возвращает каждый эндпоинт AnyAPI, поэтому разбор второго эндпоинта это смена URL и ничего больше.

За последние 30 дней 100,0% вызовов AliExpress Отзывы через AnyAPI завершились успешно, медианное время ответа 2,0 с, измерено вызовов: 1. Это собственные измерения AnyAPI по трафику через шлюз, пересчитываемые непрерывно, а не опубликованный целевой уровень обслуживания.

Да. Новый аккаунт AnyAPI стартует с бесплатным балансом 0,10 USD, карта не нужна. Этого хватает на 117 вызовов AliExpress Отзывы по 0,00085 USD за каждый.

AnyAPI в том же запросе обращается к следующему из источников (их 2), начиная с самого дешёвого, поэтому отказ одного источника не ломает ваш вызов.

Отправьте запрос POST на https://api.getanyapi.com/v1/run/aliexpress.reviews с вашим ключом AnyAPI в заголовке "Authorization: Bearer" и входными данными в теле JSON. Один и тот же ключ и один и тот же кошелёк работают на каждом эндпоинте AnyAPI.

Нет. Вы пополняете один предоплаченный баланс AnyAPI в долларах США, и каждый запрос списывает с него. Ежемесячного тарифа и минимума нет, а один и тот же баланс оплачивает каждый эндпоинт AnyAPI.

Да. Установите @getanyapi/sdk из npm для TypeScript или getanyapi из pip для Python. Оба вызывают любой эндпоинт AnyAPI с одним и тем же ключом, а ещё подойдёт любой HTTP-клиент.

Да. Агент может подключиться к MCP-серверу AnyAPI по адресу https://api.getanyapi.com/mcp или создать собственный бесплатный пробный ключ одним POST без аутентификации на https://api.getanyapi.com/agent/signup и вызывать этот эндпоинт по HTTP.