Piloterr

AliExpress Reviews

GET
/v2/aliexpress/product/reviews

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.

Credit cost: 1 credit per call

Autorização

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Parâmetros de consulta

query*string

AliExpress product id or item URL.

Example (product id):

1005001388303149

Example (item URL):

https://www.aliexpress.com/item/1005001388303149.html

Notes:

  • A numeric product id and a /item/{id}.html URL are both accepted.
  • Locale subdomains work (es., fr., de., ...).
  • A feedback URL that already contains productId is accepted. If that URL includes page and you leave page at 1, the URL page is used.
  • Other domains return 400.
page?number

Page number, starting at 1. Defaults to 1. The feed returns up to 20 reviews per page. pagination.next is the next page URL, or null on the last page.

return_page_source?boolean

When true, return the raw feed body as {"result": "..."} instead of parsed JSON. Defaults to false.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Corpo da resposta

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/aliexpress/product/reviews?query=string'
Example Response
{  "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  }}