Descriptions & export

Read each product's current description or export the full catalog to CSV.

The current description

With the catalog:read scope, fetch a product's current description (the latest successful generation), per language. With ?language= you filter to one language; without it, all available languages are returned. If the product has none yet, the list comes back empty:

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 carries the full description by field (long description, meta title, meta description, SEO/GEO attributes…) according to your organization's configured template. generation_id identifies the exact generation, in case you need to audit it.

CSV export

With the export scope, download the full generated catalog as CSV (Adobe Commerce format): each live product's latest description, ready to import into your store.

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