Descriptions et export

Lisez la description en vigueur de chaque produit ou exportez le catalogue complet en CSV.

La description actuelle

Avec le scope catalog:read, récupérez la description en vigueur d'un produit (la dernière génération réussie), par langue. Avec ?language= vous filtrez sur une langue ; sans lui, toutes les langues disponibles sont renvoyées. Si le produit n'en a encore aucune, la liste arrive vide :

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 porte la description complète par champ (description longue, meta title, meta description, attributs SEO/GEO…) selon le modèle configuré de votre organisation. generation_id identifie la génération exacte, si vous devez l'auditer.

Export CSV

Avec le scope export, téléchargez le catalogue généré complet en CSV (format Adobe Commerce) : la dernière description de chaque produit actif, prête à importer dans votre boutique.

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