Caso de uso

Pesquisa de produtos com avaliações do AliExpress

Antes de escolher um produto ou um fornecedor, leia o que milhares de compradores já disseram. A API transforma as avaliações em dados que pode comparar.

Obter uma API key grátis Ver a documentação

As avaliações dizem mais do que as estrelas

Dois anúncios do mesmo produto podem ter 4,7 estrelas e ser muito diferentes: um com 5% de avaliações de 1 estrela a queixar-se dos tamanhos, o outro quase sem nenhuma. A média esconde-o; a distribuição e o conteúdo das avaliações, não.

Com a API obtém, para qualquer produto do AliExpress, a distribuição das classificações, o número de avaliações com fotos e as próprias avaliações filtradas por estrelas, e pode automatizá-lo para dezenas de produtos.

O que pode analisar

Comparar fornecedores do mesmo produto por média, volume de avaliações e percentagem de avaliações negativas.
Detetar problemas recorrentes: leia só as avaliações de 1 e 2 estrelas e procure padrões (tamanhos, materiais, envio, defeitos).
Verificar um mercado: as avaliações de um país concreto (filter=local) mostram como o produto se comporta com compradores como os seus.
Alimentar as suas ferramentas: análise de sentimento, dashboards ou um LLM que resuma os prós e os contras.

Exemplo: escolha o melhor fornecedor

O primeiro script compara vários anúncios usando só o resumo das avaliações (um pedido por anúncio, com pageSize=1). O segundo lê as avaliações de 1 estrela do escolhido para ver o que corre mal.

Python — compare suppliers

# Compare several AliExpress listings of the same product before choosing a supplier.
import os
import requests

API = "https://api.aliexpress-reviews.com"
HEADERS = {"x-api-key": os.environ["REVIEWS_API_KEY"]}

def summary(product_id):
    res = requests.get(f"{API}/v1/reviews/{product_id}", headers=HEADERS, params={"pageSize": 1}, timeout=30)
    res.raise_for_status()
    return res.json()["summary"]

for product_id in ["1005006123456789", "1005007654321098"]:
    s = summary(product_id)
    dist = s["ratingDistribution"]
    total = sum(dist.values()) or 1
    negative = (dist["1"] + dist["2"]) / total
    print(f"{product_id}: {s['averageRating']}★ · {s['totalReviews']} reviews · {negative:.0%} negative")

Python — read the complaints

# Read the 1-star reviews to find recurring problems (sizing, shipping, quality…).
res = requests.get(
    f"{API}/v1/reviews/1005006123456789",
    headers=HEADERS,
    params={"filter": "1", "pageSize": 20},
    timeout=30,
)
for review in res.json()["data"]:
    print(review["country"], review["date"], review["content"])

Os dados de cada resposta

summary: averageRating, totalReviews, ratingDistribution (avaliações por estrela) e filterCounts (com fotos, com comentário adicional, locais).
data: cada avaliação com classificação, texto (traduzido e original), país, data, variante comprada (sku) e votos de utilidade.
Paginação: total e totalPages para percorrer todas as avaliações de um produto.

Perguntas

Posso analisar muitos produtos de uma vez?

Sim. Cada produto é um pedido, e o resumo vem em todas as respostas: comparar 100 produtos custa 100 pedidos (o plano Pro inclui 1.000 por dia).

Vejo que variante comprou cada comprador?

Sim. O campo sku indica a variante (cor, tamanho…), útil para perceber, por exemplo, que um tamanho veste pequeno.

Posso usá-la com Python, Google Sheets ou ferramentas no-code?

Sim. É uma API REST com um cabeçalho x-api-key, por isso funciona com qualquer linguagem e com ferramentas como Make, Zapier ou n8n.

Experimente com os seus produtos

100 pedidos por dia grátis, sem cartão. Cole o ID de um produto no tester do painel e veja o JSON.

Obter uma API key grátis Preços