Caso de uso

Importe avaliações do AliExpress para a sua loja Shopify

O seu produto tem milhares de avaliações no AliExpress e nenhuma na sua loja. Obtenha-as em JSON, fique com as que interessam e importe-as na sua app de avaliações.

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

O problema de copiar avaliações à mão

Uma página de produto nova sem avaliações converte pior, e as avaliações que o seu fornecedor já tem são a melhor prova social que pode conseguir. Mas copiá-las do AliExpress uma a uma não escala, e as extensões e os scrapers deixam de funcionar sempre que o AliExpress muda a página.

A API dá-lhe as mesmas avaliações que o AliExpress mostra na página do produto, com os mesmos filtros, num formato JSON estável que pode automatizar.

Como funciona

Encontre o ID do produto no URL do AliExpress: o número em aliexpress.com/item/1005006123456789.html.
Escolha as avaliações: só 5 estrelas (filter=5), só com fotos (filter=image) ou as de compradores do país dos seus clientes (filter=local&country=PT).
Traduza-as para o seu idioma com lang: pt_BR, es_ES, fr_FR… O AliExpress devolve a tradução e o texto original.
Exporte-as para CSV e importe-as com Judge.me, Loox, Ali Reviews ou qualquer app que aceite CSV.

Exemplo: do AliExpress a um CSV em 20 linhas

Este script pede as avaliações de 5 estrelas de um produto e escreve um CSV. Troque my-product pelo handle do produto no Shopify e adapte as colunas ao modelo de importação da sua app de avaliações.

Node.js — reviews to CSV

// Export the 5-star reviews of an AliExpress product as a CSV
// that review apps (Judge.me, Loox, Ali Reviews…) can import.
const API = 'https://api.aliexpress-reviews.com';
const headers = { 'x-api-key': process.env.REVIEWS_API_KEY };

const res = await fetch(`${API}/v1/reviews/1005006123456789?filter=5&pageSize=20`, { headers });
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const { data } = await res.json();

const cell = (value) => `"${String(value ?? '').replaceAll('"', '""')}"`;
const header = ['product_handle', 'rating', 'body', 'reviewer_name', 'location', 'review_date', 'picture_urls'];
const rows = data.map((r) =>
  ['my-product', r.rating, r.content, r.author, r.country, r.date, (r.images ?? []).join(',')].map(cell).join(','),
);

console.log([header.join(','), ...rows].join('\n'));

Os filtros que importam numa loja

Com fotos (filter=image, plano Max): as avaliações com fotos de clientes são as que mais convertem. A resposta inclui os URL das imagens.
Do seu mercado (filter=local + country, plano Pro): avaliações de compradores do mesmo país que os seus clientes.
Traduzidas (lang, plano Pro): a avaliação no idioma da sua loja, com originalContent caso queira mostrar o original.
Resumo das avaliações (todos os planos): média, total e distribuição por estrelas, para mostrar no topo da página.

Use-as com transparência

Mostre-as como o que são: avaliações do produto de compradores do AliExpress, não dos seus clientes. Muitas apps de avaliações permitem indicar a origem, e na UE a lei do consumidor obriga a informar de onde vêm as avaliações. É também o que gera confiança.

Perguntas

Funciona com WooCommerce, Wix ou outras plataformas?

Sim. A API devolve JSON, que pode converter no formato que a sua plataforma ou o seu plugin de avaliações importa. O exemplo gera um CSV, o formato mais comum.

Posso importar as fotos das avaliações?

Sim, com o plano Max: filter=image devolve só as avaliações com fotos, e cada avaliação inclui os URL das suas imagens e miniaturas.

Quantas avaliações posso obter?

Até 20 por pedido no Free e até 100 no Pro e no Max, com paginação para as percorrer todas. A quota é de 100, 1.000 ou 10.000 pedidos por dia, consoante o plano.

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.

Obter uma API key grátis Preços