Caso de uso
Avaliações do AliExpress para o seu blog
Uma análise de produto vale tanto quanto as suas provas. Apoie a sua na distribuição das classificações e nas palavras de milhares de compradores reais.
Da opinião à evidência
A maioria dos artigos “o melhor do AliExpress” repete o anúncio. Um artigo que diz “4,4 estrelas de 452 compradores, 7% deles dão 1 estrela e a queixa habitual é o auricular esquerdo” é mais útil e mais credível, e posiciona-se nas perguntas de cauda longa que os leitores realmente pesquisam.
Com a API obtém o resumo e as avaliações de qualquer produto, e assim pode escrever sobre o que dizem os compradores em vez de adivinhar.
O que pode fazer com ela
- Mostrar uma caixa de classificação no seu artigo com a média, o total e a distribuição por estrelas.
- Escrever prós e contras a partir das avaliações de 5 e 1 estrelas, ou deixar que um LLM as resuma.
- Citar compradores reais, com país e data, traduzidos para o idioma dos seus leitores.
- Manter os rankings atualizados recompilando o site periodicamente para que os números estejam sempre em dia.
Exemplo: obtenha os dados quando o seu site compila
Faça-o na compilação, não no navegador do visitante: a sua API key fica privada e as suas páginas continuam rápidas. Este script Node.js escreve um ficheiro JSON que o Astro, Eleventy, Next.js, Hugo ou Jekyll podem ler como dados.
// build-reviews.mjs — run before your site builds (e.g. "prebuild": "node build-reviews.mjs").
// Writes the rating summary and the best and worst reviews of each product to a JSON file your pages can import.
import { writeFileSync } from 'node:fs';
const API = 'https://api.aliexpress-reviews.com';
const PRODUCTS = ['1005006123456789']; // AliExpress product ids you write about
const headers = { 'x-api-key': process.env.REVIEWS_API_KEY };
async function get(id, filter) {
const res = await fetch(`${API}/v1/reviews/${id}?filter=${filter}&pageSize=5`, { headers });
if (!res.ok) throw new Error(`${id}: HTTP ${res.status}`);
return res.json();
}
const out = {};
for (const id of PRODUCTS) {
const best = await get(id, '5');
const worst = await get(id, '1');
out[id] = { summary: best.summary, praise: best.data, complaints: worst.data };
}
writeFileSync('src/data/aliexpress-reviews.json', JSON.stringify(out, null, 2));Detalhes que vale a pena acertar
- Nunca ponha a key em código do lado do cliente. Tudo o que está no navegador pode ser copiado.
- Um pedido por produto e por compilação chega: o resumo vem com a primeira página de avaliações.
- Diga de onde vêm os dados e ligue ao produto. Leitores e motores de pesquisa confiam em números com fonte.
- Verifique as regras do seu programa de afiliados. Os programas diferem na forma como permitem citar avaliações e classificações.
Perguntas
Funciona com WordPress, Ghost ou um site estático?
Sim. É uma API REST com um cabeçalho x-api-key, por isso pode chamá-la a partir de PHP, de um script de compilação ou de uma função serverless e mostrar o resultado em qualquer CMS.
Posso mostrar as avaliações diretamente no navegador?
Recomendamos que não: a key ficaria visível para qualquer pessoa. Obtenha os dados na compilação ou através de um pequeno endpoint próprio no servidor.
De quantos pedidos preciso?
Um por produto e por compilação chega para o resumo e as primeiras avaliações. O plano Free tem 100 pedidos por dia, o que cobre um blog com dezenas de produtos.
A API é afiliada ao AliExpress?
Não. Devolve as avaliações públicas que o AliExpress mostra nas páginas de produto, mas é um serviço independente.
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.