Documentación API

Todos los endpoints devuelven JSON. No requiere autenticación.

Última actualización: 20 de abril de 2026

Base URL
https://www.quipu.solutions
Endpoints de Datos
GET /api/briefing

Devuelve los datos del último sweep de todas las fuentes como objeto JSON. Contiene estados de fuentes, conteos, alertas y timestamps.

curl https://www.quipu.solutions/api/briefing
GET /api/briefing/llm

Genera un briefing de información con IA a partir de los datos del último sweep usando Groq o un modelo local Ollama.

Parámetros de consulta
model Identificador del modelo, ej. groq:llama-3.3-70b-versatile opcional
lang Idioma del briefing: es o en (default: es) opcional
key API key de Groq personalizada opcional
curl "https://www.quipu.solutions/api/briefing/llm?model=groq:llama-3.3-70b-versatile&lang=es"
GET /api/ollama/models

Lista los modelos LLM disponibles (Ollama + Groq), incluyendo el modelo seleccionado y estado de Ollama.

curl https://www.quipu.solutions/api/ollama/models
Historial y Alertas
GET /api/history/:sourceId

Devuelve datos históricos de sweeps para una fuente específica. Usado para sparklines en el dashboard.

Parámetros de ruta
sourceId Identificador de fuente, ej. usgs, firms, gdelt
Parámetros de consulta
limit Cantidad de registros (default: 50, máx: 500) opcional
curl "https://www.quipu.solutions/api/history/usgs?limit=50"
GET /api/alerts

Devuelve las últimas 100 alertas generadas por el análisis de sweeps. Incluye niveles de severidad, fuentes y timestamps.

curl https://www.quipu.solutions/api/alerts
Exportación
GET /api/export/json

Descarga los datos del último sweep como archivo JSON.

curl -O https://www.quipu.solutions/api/export/json
GET /api/export/csv

Descarga los datos del último sweep como archivo CSV con columnas: source_id, ok, count, ts.

curl -O https://www.quipu.solutions/api/export/csv
Alcance y Región
GET /api/scope

Devuelve el alcance geográfico actual y todos los alcances disponibles.

curl https://www.quipu.solutions/api/scope
GET /api/scope/:scope

Cambia el alcance geográfico activo. Dispara un nuevo sweep con el bounding box actualizado y notifica a todos los clientes SSE conectados.

Parámetros de ruta
scope sa, eu, na, asia, meast, africa
curl https://www.quipu.solutions/api/scope/sa
Streaming en Tiempo Real
GET /api/stream

Endpoint SSE (Server-Sent Events) para datos en tiempo real. Envía el último briefing al conectarse y pushea nuevos datos con cada sweep. Cada mensaje es un JSON con campo type. Tipos: briefing (sweep completo cada 60s), pulse (mini-sweep de sismos y aviones cada 10s).

curl -N https://www.quipu.solutions/api/stream
Información y Análisis
GET /api/risk

Devuelve el último análisis de riesgo político por IA para 20 países LATAM. Se actualiza cada 30 minutos vía Groq LLM. Cada país tiene nivel de riesgo (low/medium/high/critical), razón, acción recomendada y tendencia.

curl https://www.quipu.solutions/api/risk
GET /api/insights

Devuelve índices computados en tiempo real: tensión social por país, detección de anomalías, correlación cross-source y demanda energética (CAMMESA). Se actualiza cada sweep.

curl https://www.quipu.solutions/api/insights
GET /api/brief

Devuelve el último briefing ejecutivo generado por IA. Contiene un resumen estructurado de la situación de información.

curl https://www.quipu.solutions/api/brief
GET /api/country/:code

Devuelve datos detallados de un país específico incluyendo tipos de cambio, datos del banco central y análisis de riesgo.

Parámetros de ruta
code AR, BR, CL, CO, PE, VE, MX, UY, EU, JP
curl https://www.quipu.solutions/api/country/AR
Sistema
GET /api/health

Endpoint de health check. Devuelve uptime, timestamp del último sweep y cantidad de clientes SSE conectados.

curl https://www.quipu.solutions/api/health
GET /api/stats

Devuelve estadísticas del dashboard: fuentes OK/total, cantidad de alertas, tiempo de sweep y vistas de página.

curl https://www.quipu.solutions/api/stats
GET /api/iss

Proxy de la posición de la ISS (evita bloqueo de contenido mixto). Devuelve latitud/longitud actual de la Estación Espacial Internacional.

curl https://www.quipu.solutions/api/iss
GET /api/sweep

Dispara manualmente un nuevo sweep de todas las fuentes. Devuelve los datos completos del briefing. Usar con moderación — el sistema ya hace sweep cada 60 segundos.

curl https://www.quipu.solutions/api/sweep