Caso de uso

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

O BigCommerce tem uma API de avaliações e o AliExpress tem as avaliações. Ligue os dois com um script curto e os seus produtos passam a ter avaliações nativas.

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

Duas APIs, um script

O BigCommerce permite criar avaliações de produto através da Catalog API, por isso não há nada para fazer scraping do seu lado nem nada para instalar na loja. Só precisa das avaliações num formato limpo, que é o que esta API devolve.

As avaliações criadas assim são avaliações normais do BigCommerce: o seu tema e a classificação por estrelas das suas páginas de produto usam-nas como quaisquer outras.

Como funciona

Encontre o ID do produto no AliExpress no URL: o número em aliexpress.com/item/1005006123456789.html.
Escolha as avaliações com filter: uma classificação por estrelas, avaliações com fotos ou avaliações de um país.
Traduza-as com lang para coincidirem com o idioma da sua loja.
Crie-as com POST /v3/catalog/products/{id}/reviews usando um token de API do BigCommerce com o scope de produtos.

Exemplo: do AliExpress a avaliações do BigCommerce

Um script Node.js que lê as avaliações de 5 estrelas de um produto do AliExpress e as cria como avaliações de um produto do BigCommerce. Defina o store hash, o token de API e o id do produto no BigCommerce.

Node.js — reviews to BigCommerce

// Create BigCommerce product reviews from the 5-star reviews of an AliExpress product.
const API = 'https://api.aliexpress-reviews.com';
const STORE_HASH = process.env.BC_STORE_HASH;
const BC_PRODUCT_ID = 123; // your BigCommerce product

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

for (const r of data) {
  const created = await fetch(
    `https://api.bigcommerce.com/stores/${STORE_HASH}/v3/catalog/products/${BC_PRODUCT_ID}/reviews`,
    {
      method: 'POST',
      headers: {
        'X-Auth-Token': process.env.BC_ACCESS_TOKEN,
        'Content-Type': 'application/json',
        Accept: 'application/json',
      },
      body: JSON.stringify({
        title: r.content.slice(0, 60),
        text: r.content,
        status: 'pending', // review them in the control panel, then approve
        rating: r.rating,
        name: r.author,
        date_reviewed: new Date(r.date).toISOString(),
      }),
    },
  );
  if (!created.ok) console.error(r.id, created.status, await created.text());
}

Detalhes que vale a pena acertar

Execute-o no servidor. Tanto a API key das avaliações como o token do BigCommerce são segredos: use um script, uma função serverless ou cron.
Respeite os limites de pedidos do BigCommerce e crie as avaliações de forma sequencial ou em pequenos lotes.
Evite duplicados guardando os ids das avaliações do AliExpress que já criou.
Moderação: crie-as com o estado que preferir (pending para as rever primeiro, approved para as publicar).

Use-as com transparência

Mostre-as como avaliações do produto de compradores do AliExpress, não dos seus clientes. A lei do consumidor em muitos países obriga a informar de onde vêm as avaliações, e é também o que gera confiança.

Perguntas

Que permissão do BigCommerce preciso?

Uma conta de API ao nível da loja cujo token possa modificar produtos no scope Catalog. Mantenha o token no servidor, como a API key das avaliações.

Posso importar as fotos das avaliações?

No plano Max, filter=image devolve só as avaliações com fotos e inclui os respetivos URL de imagem. O endpoint de avaliações do BigCommerce não tem campo de imagem, por isso adicione-as ao texto ou aloje-as você mesmo.

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