Descrições e export

Leia a descrição vigente de cada produto ou exporte o catálogo completo em CSV.

A descrição atual

Com o scope catalog:read, obtenha a descrição vigente de um produto (a última geração bem-sucedida), por idioma. Com ?language= você filtra um idioma; sem ele, devolve todos os idiomas disponíveis. Se o produto ainda não tem nenhuma, a lista vem vazia:

GET /v1/products/{id}/descriptions?language=es

{
  "product_id": "…",
  "descriptions": [
    {
      "generation_id": "…",
      "language": "es",
      "fields": { "descripcion_larga": "…", "meta_title": "…", … },
      "generated_at": "2026-07-23T18:00:00Z"
    }
  ]
}

fields traz a descrição completa por campo (descrição longa, meta title, meta description, atributos SEO/GEO…) conforme o template configurado da sua organização. generation_id identifica a geração exata, caso precise auditá-la.

Export CSV

Com o scope export, baixe o catálogo gerado completo em CSV (formato Adobe Commerce): a última descrição de cada produto ativo, pronta para importar na sua loja.

curl -s "https://bruxel.ai/api/public/v1/export/catalog.csv" \
  -H "Authorization: Bearer bxk_…" -o catalogo.csv