Descripciones y export

Lee la descripción vigente de cada producto o exporta el catálogo completo a CSV.

La descripción actual

Con el scope catalog:read, obtén la descripción vigente (la última generación exitosa) de un producto, por idioma. Con ?language= filtras a un idioma; sin él, devuelve todos los idiomas disponibles. Si el producto aún no tiene ninguna, la lista llega vacía:

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 trae la descripción completa por campos (descripción larga, meta title, meta description, atributos SEO/GEO…) según la plantilla configurada de tu organización. generation_id identifica la generación exacta, por si necesitas auditarla.

Export CSV

Con el scope export, descarga el catálogo timbrado completo en CSV (formato Adobe Commerce): la última descripción de cada producto vivo, listo para importarse en tu tienda.

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