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.
Primeros pasos
Crea una API key, conoce la base URL y haz tu primera llamada autenticada.
Ir al Quickstart →SeguridadAutenticación
Llaves bxk_ por organización, permisos por scope y entrega de un solo uso.
Ver el ejemplo →OpenAPIReferencia de la API
Explora los endpoints con sus esquemas, parámetros y respuestas de ejemplo.
Ver el Quickstart →CódigoEjemplos
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"import httpx
BASE = "https://bruxel.ai/api/public/v1"
headers = {"Authorization": "Bearer bxk_tu_llave"}
# Genera una descripción y léela
r = httpx.post(
f"{BASE}/generations",
headers=headers,
json={"product_id": "prod_8f2", "language": "es"},
)
r.raise_for_status()
print(r.json()["description"])const BASE = "https://bruxel.ai/api/public/v1";
const headers = {
Authorization: "Bearer bxk_tu_llave",
"Content-Type": "application/json",
};
// Genera una descripción y léela
const res = await fetch(`${BASE}/generations`, {
method: "POST",
headers,
body: JSON.stringify({ product_id: "prod_8f2", language: "es" }),
});
const data = await res.json();
console.log(data.description);Últimos cambios
Novedades de la API pública.
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.
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.
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.