La API de Furia Reports: tus informes en JSON, en una línea

Para qué quieres una API en una herramienta de informes

Una herramienta de informes que no deja sacar los datos es una jaula bonita. Puedes mirarlos, pero no llevártelos: si tu jefe los quiere en el Excel de siempre, o tu CRM necesita el coste por lead para calcular márgenes, o quieres que una IA te resuma la semana, te toca copiar a mano.

La API de Furia Reports existe para eso: una clave, una cabecera y los mismos números que ves en el panel, en JSON. Sin SDK que instalar, sin OAuth que implementar, sin webhooks que mantener vivos. Todo son peticiones GET.

Los tres usos que más se piden, por orden:

• Preguntarle a una IA por tus campañas. Un asistente con acceso de lectura a tus informes responde «¿qué campaña me está subiendo el CPL este mes?» con datos reales en lugar de inventárselo.
• Llevar el dato a donde ya trabajas. El coste real por lead al CRM, el gasto diario a la hoja de márgenes, el ROAS real al panel interno.
• Automatizar el aviso. Un flujo en n8n o Make que mira el gasto de ayer y te escribe por Slack si se sale de rango.

Cómo funciona: una clave, una cabecera, JSON

Se crea en Ajustes → API de Furia Reports. Le pones nombre (te agradecerás haber puesto «CRM de Aitor» y no «clave 3»), y la copias: por seguridad se enseña una sola vez, porque lo que guardamos en base de datos es su hash, no la clave.

A partir de ahí, va en la cabecera Authorization de cada petición:

curl -H "Authorization: Bearer frk_TU_CLAVE" \
     https://furiareports.com/api/ping

Y la respuesta te dice de quién es la clave, que es la forma rápida de comprobar que todo está en su sitio:

{ "ok": true, "workspace": "Allora Publicidad", "plan": "pro", "via": "api_key" }

No hay más ceremonia. Todas las rutas cuelgan de https://furiareports.com/api, todas son GET y todas devuelven JSON.

Qué puedes leer

Los endpoints principales, con lo que devuelve cada uno:

El dinero va en euros (número, no céntimos) y las métricas llegan ya sumadas. La lista completa, con el formato exacto de cada respuesta, está en la documentación de la API.

Rangos de fechas y varias cuentas

El parámetro range acepta atajos (hoy, ayer, 7d, 30d, 90d) o un rango libre con since y until en formato YYYY-MM-DD, hasta un máximo de 366 días por petición.

Si gestionas varias cuentas o varios clientes, añades account= o client= y la respuesta se limita a esa. Sin ese parámetro obtienes lo mismo que verías al entrar al panel.

GET /api/crossdata/roas?range=30d&client=<id>

Límites, caché y errores

Por clave: 60 peticiones por minuto y 1.000 por hora. Suena poco hasta que se piensa: los datos se cachean unos 15 minutos en servidor, así que pedir el mismo rango cada dos segundos no te da información más fresca, solo gasta tu cuota. Al pasarte, la respuesta es un 429 con la cabecera Retry-After diciéndote cuántos segundos esperar.

Los errores que verás:

Y una promesa que va con todo lo que hacemos: si una fuente falla, la API lo dice. Nunca rellena con ceros. Un cero silencioso en un informe es peor que un error, porque el error lo investigas y el cero te lo crees.

Enchufarla a una IA (el caso que más se pide)

Es el motivo por el que la mitad de la gente pide una clave. La receta corta: crea la clave, dale a tu asistente la URL base y la cabecera, y dile qué endpoint usar para cada pregunta.

Una instrucción de sistema que funciona bien:

Tienes acceso de lectura a la API de Furia Reports por HTTPS (solo GET,
cabecera Authorization: Bearer <clave>). Usa /api/panel para Meta,
/api/google/panel para Google y /api/crossdata/roas para el ROAS real.
Si un dato no está en la respuesta, dilo. No estimes ni completes cifras.

Esa última línea es la importante. Un modelo al que se le pide un informe y le falta un dato tiende a rellenar el hueco con algo verosímil, y un número verosímil en un informe de cliente es una bomba con temporizador. Con acceso a datos reales y permiso explícito para decir «no lo tengo», el resultado es otra cosa.

Qué NO puede hacer una clave

Esto es tan importante como lo que sí puede, así que va explícito:

• No escribe. Ni conecta ni desconecta cuentas publicitarias, ni cambia tu configuración, ni toca tus clientes, ni borra datos.
• No paga ni cobra. Los endpoints de facturación y suscripción quedan fuera: exigen tu sesión con 2FA.
• No sale de tu workspace. La clave ve tus cuentas, tus clientes y tus ventas. Los datos de otro usuario de Furia Reports son inalcanzables para ella, por construcción y no por buena voluntad: cada consulta lleva tu identificador en la propia consulta a base de datos.
• No sobrevive a un clic. La revocas en Ajustes y muere en el acto, sin propagaciones ni esperas.

Por dónde empezar

1. Entra en Ajustes → API de Furia Reports y crea una clave con un nombre que te diga algo dentro de seis meses.
2. Comprueba que responde: curl -H "Authorization: Bearer frk_…" https://furiareports.com/api/ping.
3. Pide tu primer informe de verdad: /api/crossdata/roas?range=30d, que es el que enseña la diferencia entre lo que declara el píxel y lo que dice tu tienda.

Los ejemplos completos en cURL, Node y Python están en la documentación. Y si lo que te interesa es la otra punta del tubo — cómo entran los datos antes de poder sacarlos —, la guía avanzada de la conexión con Google Ads cuenta lo que hay detrás de un simple «iniciar sesión con Google».