bruxel.aiDevelopers

Bruxel Public API · v1

Integra Bruxel en tu sistema

Una API REST para generar descripciones de producto optimizadas para SEO y GEO directamente desde tu backend, PIM o e-commerce. Empuja tu catálogo, timbra descripciones y exporta — sin tocar la interfaz.

Base URLhttps://bruxel.ai/api/public/v1Autenticación Bearer bxk_…Formato JSON
Empezar

Primeros pasos

Crea una API key, conoce la base URL y haz tu primera llamada autenticada.

Ir al Quickstart
Seguridad

Autenticación

Llaves bxk_ por organización, permisos por scope y entrega de un solo uso.

Ver el ejemplo
OpenAPI

Referencia de la API

Explora los endpoints con sus esquemas, parámetros y respuestas de ejemplo.

Ver el Quickstart
Código

Ejemplos

Flujos completos en curl, Python y JavaScript listos para copiar.

Ver ejemplos

Quickstart

Del cero a una descripción generada. Reemplaza bxk_tu_llave por la que creaste en la consola.

# 1) Verifica que tu llave funciona
curl -s https://bruxel.ai/api/public/v1/me \
  -H "Authorization: Bearer bxk_tu_llave"

# 2) Empuja productos a tu catálogo (upsert por SKU)
curl -s -X POST https://bruxel.ai/api/public/v1/products \
  -H "Authorization: Bearer bxk_tu_llave" \
  -H "Content-Type: application/json" \
  -d '{"products":[{"sku":"MRN-CREW-01","name":"Suéter de lana merino"}]}'

# 3) Genera la descripción (síncrono — cobra créditos)
curl -s -X POST https://bruxel.ai/api/public/v1/generations \
  -H "Authorization: Bearer bxk_tu_llave" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"prod_8f2","language":"es"}'

# 4) Exporta tu catálogo timbrado a CSV
curl -s "https://bruxel.ai/api/public/v1/export/catalog.csv?language=es" \
  -H "Authorization: Bearer bxk_tu_llave"

Últimos cambios

Novedades de la API pública.

2026-07-21
llavesauth

API keys por organización

Nuevas llaves bxk_ con permisos por scope (catalog:read, generate, export…), entrega de un solo uso y revocación inmediata desde la consola.

2026-07-21
generación

Lotes asíncronos con idempotencia

Endpoint POST /v1/batches para timbrar en volumen: reserva de créditos, Idempotency-Key obligatoria y cobro por resultado al leer.

2026-07-13
export

Export de catálogo por idioma

GET /v1/export/catalog.csv?language=es devuelve tu catálogo timbrado en el idioma solicitado, compatible con Adobe Commerce y Shopify.

Ver el changelog completo

Bruxel para desarrolladores — API pública