La API de Furia Reports

01Empezar en 30 segundos

1. Entra en Furia Reports → Ajustes → API de Furia Reports.
2. Pulsa ＋ Nueva clave, ponle un nombre (p. ej. «CRM de Aitor») y cópiala. Solo se muestra una vez.
3. Úsala en la cabecera Authorization de tus peticiones. Ya está.

# comprueba que tu clave funciona
curl -H "Authorization: Bearer frk_TU_CLAVE" \
     https://furiareports.com/api/ping

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

02Autenticación

Cada petición lleva tu clave en la cabecera Authorization con el prefijo Bearer:

Authorization: Bearer frk_xxxxxxxxxxxxxxxxxxxxxxxx

• La clave representa a tu workspace: ve exactamente los mismos datos que tú en el panel (tus cuentas de Meta/Google, tus clientes, tu cruce de ventas).
• Es de solo lectura: no puede conectar/desconectar cuentas, ni facturar, ni cambiar nada.
• Guárdala como un secreto (variable de entorno, gestor de secretos). Nunca la pongas en código de cliente ni en un repositorio público.
• ¿Se filtró? Revócala en Ajustes y crea otra — la vieja deja de funcionar al instante.

03Límites de uso

Por clave, con ventana fija. Los datos se cachean en servidor (~15 min), así que estos límites sobran para cualquier integración razonable:

Cachea del lado del cliente lo que no cambie a menudo. No hace falta pedir el mismo rango cada pocos segundos.

04Endpoints

Todos son GET y devuelven JSON. El parámetro de fecha range acepta: hoy, ayer, hoyayer, 7d, 14d, 30d, 90d, max (desde que se creó la cuenta; añade since= con la fecha de /api/panel/account-start) o un rango libre custom&since=YYYY-MM-DD&until=YYYY-MM-DD (máx. 36 meses, el límite de Meta). Todas las fechas van en hora de Madrid (Europe/Madrid): «hoy» es el día de Madrid en cualquier cuenta. Si gestionas varias cuentas, añade account=act_123 o client=<id>.

05Formato de respuesta

Ejemplo abreviado de GET /api/panel?range=30d. El dinero va en euros (número, no céntimos); las métricas están ya sumadas y cuadran entre tot, daily y camps.

{
  "range": "30d", "days": 30,
  "source": "meta",            // "meta" = datos reales · "demo" = cuenta de demostración
  "account": { "id": "act_123", "name": "Mi Cuenta", "currency": "EUR" },
  "cur": {
    "tot": { "spend": 4538.10, "imp": 454133, "clk": 6274,
             "leads": 711, "compras": 36, "rev": 57857.00, "reach": 198340 },
    "daily": [ { "date": "2026-06-12", "spend": 151.20, "leads": 24, "compras": 1, ... } ],
    "camps": [ { "n": "Leads – Advantage+", "active": true, "spend": 1140.00,
               "leads": 311, "compras": 12, "rev": 19100.00, ... } ]
  },
  "prev": { /* misma forma: el periodo anterior, para calcular variaciones */ }
}

Métricas derivadas (CPL, CPM, CPC, ROAS, CTR) las calculas tú a partir de estos campos crudos, para que nunca haya redondeos escondidos:

• CPL = spend / leads · CPM = spend / imp × 1000 · CPC = spend / clk
• ROAS = rev / spend · CTR = clk / imp × 100

06Ejemplos

cURL

curl -H "Authorization: Bearer $FURIA_KEY" \
  "https://furiareports.com/api/crossdata/roas?range=30d"

Node.js (fetch)

const res = await fetch("https://furiareports.com/api/panel?range=30d", {
  headers: { Authorization: `Bearer ${process.env.FURIA_KEY}` }
});
const data = await res.json();
console.log("Gasto:", data.cur.tot.spend, "€ · Leads:", data.cur.tot.leads);

Python (requests)

import os, requests
r = requests.get(
    "https://furiareports.com/api/panel",
    params={"range": "30d"},
    headers={"Authorization": f"Bearer {os.environ['FURIA_KEY']}"},
)
d = r.json()
print("ROAS:", d["cur"]["tot"]["rev"] / d["cur"]["tot"]["spend"])

07Usarla con una IA (Claude, ChatGPT…)

Este es el caso que hace magia: das tu clave a un asistente y le preguntas por tus campañas en lenguaje natural. Como todo son GET con una cabecera, cualquier IA con acceso a herramientas (Claude con MCP/HTTP, GPTs personalizados, agentes) puede consultarla.

GPT personalizado / agente

• Base URL: https://furiareports.com/api
• Autenticación: tipo «API Key» → cabecera Authorization → valor Bearer frk_TU_CLAVE
• Acciones: los endpoints de la sección 4 (todos GET).

Instrucción de ejemplo para el asistente

Eres mi analista de paid media. Para responder, consulta la API de Furia
Reports (GET, cabecera Authorization: Bearer <clave>). Usa /api/panel para
Meta, /api/google/panel para Google y /api/crossdata/roas para el ROAS real
de tienda. Calcula CPL = spend/leads y ROAS = rev/spend. Da cifras exactas,
nunca inventes datos: si la API no lo devuelve, dilo.

08Errores

Los errores devuelven { "error": "descripción" }. Nada de datos inventados: si una fuente cae, la API lo dice, no rellena con ceros.