Documentación de la API

Integra la detección de estafas en tu aplicación con nuestra API REST.

Autenticación

Todas las solicitudes a la API requieren un token Bearer. Obtén tu clave API suscribiéndote al plan API.

Authorization: Bearer your_api_key_here

Endpoints

POST/api/v1/check

Analiza un contenido en busca de indicadores de estafa.

{
  "content": "Your suspicious text here...",
  "input_type": "text",  // "text" | "url" | "email"
  "locale": "en"         // optional, for explanation language
}

POST/api/v1/bulk

Verifica múltiples URLs o elementos de contenido en una sola solicitud.

{
  "items": [
    { "content": "https://suspicious-url.com" },
    { "content": "Check this email text..." }
  ]
}

Formato de Respuesta

{
  "id": "abc123xyz",
  "verdict": "likely_scam",
  "composite_score": 72,
  "confidence": 88,
  "scam_type": "phishing",
  "explanation": "This message...",
  "red_flags": [...],
  "layers": [...],
  "processing_time_ms": 2340
}

Límites de Tasa

Plan API: 10.000 solicitudes por día. Plan Empresa: ilimitado.