API para desarrolladores

Integra la clasificación en tu stack

Clasifica desde tu ERP, e-commerce o scripts con una sola llamada. Claves de API y resultados con citas y trazabilidad.

Nombre	Token	Último uso	Creada
Producción	clz_live_a1b2…	hace 2 h	12 mar 2026
ERP · SAP	clz_live_9f8e…	hace 1 d	3 feb 2026
Staging	clz_test_4c5d…	Nunca	20 ene 2026

Clasifica con una sola llamada

curl https://api.claz.ai/v1/classify \
  -H "x-api-key: $CLAZ_KEY" \
  -d '{"description": "Auriculares Bluetooth", "country": "AR"}'

Implementación sencilla en cualquier lenguaje

Una llamada REST para crear la clasificación y otra para leer el resultado. Sin SDK obligatorio: úsalo desde el lenguaje que ya usas.

const base = "https://api.claz.ai/v1";
const key = process.env.CLAZ_KEY!;

const { id } = await fetch(`${base}/classifications`, {
  method: "POST",
  headers: { "x-api-key": key, "content-type": "application/json" },
  body: JSON.stringify({ description: "Auriculares Bluetooth", country: "AR" }),
}).then((r) => r.json());

// Poll the status until the run is done, with a timeout.
for (let i = 0; i < 30; i++) {
  const run = await fetch(`${base}/classifications/${id}`, {
    headers: { "x-api-key": key },
  }).then((r) => r.json());
  if (run.status === "completed") return run.candidates[0];
  if (run.status === "failed") throw new Error("classification failed");
  await new Promise((r) => setTimeout(r, 2000));
}
throw new Error("timed out");

Respuesta estructurada, lista para tu sistema

Recibes el código, la confianza, el razonamiento y las citas en JSON, fácil de guardar o mostrar en tu ERP o e-commerce.

200 OK · application/json

{
  "id": "run_9f8e7d",
  "status": "completed",
  "confidence": 94,
  "candidates": [
    {
      "rank": 1,
      "code": "8518.30.00",
      "description": "Auriculares, incluso combinados con micrófono",
      "confidence": 94
    }
  ],
  "reasoning": "Se clasifica por su función principal … (RGI 1).",
  "citations": ["Nota 3 del Capítulo 85", "Nota explicativa 85.18"]
}