API de analíticasAPI

Lee las métricas de todas las redes desde un solo endpoint

FoPost recoge los datos de rendimiento de cada cuenta conectada y los devuelve en un formato coherente. Obtén un resumen del espacio de trabajo, profundiza en una publicación o sigue una cuenta a lo largo del tiempo, y envíalo a la herramienta con la que elabores tus informes.

Consigue tu clave de API Lee la documentación

GET /v1/analytics/overview

curl "https://api.fopost.com/v1/analytics/overview?workspace_id=9b2f6c1e-...&days=30" \
  -H "X-API-Key: $API_KEY"

{
  "total_accounts": 6,
  "total_followers": 42810,
  "total_posts": 86,
  "total_engagement": 9127,
  "total_impressions": 184320,
  "total_reach": 121904,
  "engagement_rate": 0.0749,
  "deltas": { "followers": 2.89, "posts": 12.5 },
  "today_stats": { "posts": 3, "follower_change": 41, "engagement": 312 },
  "platforms": [{ "platform": "linkedin", "accounts": 2, "followers": 18402 }]
}

Métricas normalizadas

Las impresiones, la interacción y los seguidores usan los mismos nombres de campo en todas las redes.

Tres niveles

Resumen del espacio de trabajo, una publicación o una cuenta.

Permiso de solo lectura

Una clave con solo el permiso analytics puede leer datos y nada más.

Resumen

Una llamada para el informe mensual

El endpoint de resumen suma un espacio de trabajo en un rango de fechas: totales de impresiones, interacciones, variación de seguidores y publicaciones realizadas, de modo que un resumen semanal o un informe de cliente es una petición y una plantilla.

Lee la referencia de analíticas

Cuentas conectadas de todas las redes en un solo espacio de trabajo

Rangos de fechas

Indica days para un periodo de hasta 365 días hacia atrás. Las variaciones lo comparan con el periodo anterior.

Filtra por cuenta

Limita el resumen a una cuenta cuando un cliente pregunte por un canal concreto.

Por espacio de trabajo

Las claves de agencia son por espacio de trabajo de cliente, así que los informes nunca se mezclan.

Por publicación

Descubre qué publicación hizo el trabajo

Cada publicación que creas con la API conserva su id, y ese id devuelve las métricas de cada red en la que apareció. Combínalo con tus propios datos de campaña, o clasifica las publicaciones del mes y descubre qué repetir.

Ver métricas por publicación

GET /v1/posts/:id/analytics

curl "https://api.fopost.com/v1/posts/7d3e0a52-.../analytics" \
  -H "X-API-Key: $API_KEY"

{
  "post_id": "7d3e0a52-...",
  "totals": { "impressions": 21050, "reach": 15230, "engagements": 1374, "likes": 501, "comments": 60, "shares": 71, "reposts": 0, "clicks": 721, "saves": 21, "video_views": 0, "follows": 12 },
  "platforms": [
    { "platform": "linkedin", "username": "yourbrand", "external_post_id": "urn:li:share:7301...", "permalink": "https://linkedin.com/feed/update/...", "metrics": { "impressions": 12840, "likes": 311, "comments": 42, "shares": 27, "clicks": 508 } },
    { "platform": "twitter", "username": "yourbrand", "external_post_id": "1830...", "permalink": "https://x.com/...", "metrics": { "impressions": 8210, "likes": 190, "comments": 18, "shares": 44, "clicks": 213 } }
  ],
  "last_fetched_at": "2026-09-02T09:00:00Z"
}

Desglose por cuenta

Una publicación, una fila por red, para que veas qué canal la impulsó.

Clics y enlaces permanentes

Los clics en enlaces y el enlace permanente en vivo llegan junto con los recuentos.

Agrupa por etiqueta

Primero lista las publicaciones por etiqueta y luego lee las métricas del conjunto.

Por cuenta

Sigue el crecimiento de cada canal a lo largo del tiempo

El endpoint de cuentas devuelve una serie de instantáneas de seguidores, alcance y visitas al perfil. Llévala a tus propios gráficos, crea una alerta ante una caída o muéstrale a un cliente la línea subiendo junto a las publicaciones que la hicieron crecer.

Empieza a construir

GET /v1/accounts/:id/analytics

curl "https://api.fopost.com/v1/accounts/4a71d80b-.../analytics?limit=7" \
  -H "X-API-Key: $API_KEY"

{
  "account_id": "4a71d80b-...",
  "platform": "linkedin",
  "username": "yourbrand",
  "history": [
    { "followers": 41651, "following": 210, "total_posts": 412, "reach": 6034, "profile_views": 341, "fetched_at": "2026-08-02T06:00:00Z" },
    { "followers": 41606, "following": 210, "total_posts": 411, "reach": 5120, "profile_views": 288, "fetched_at": "2026-08-01T06:00:00Z" }
  ]
}

Serie de instantáneas

Un punto por cada recopilación de seguidores, alcance y visitas al perfil.

Crea tus propias alertas

Consulta de forma programada y recibe un aviso cuando un canal se salga de su rango normal.

Sé dueño del historial

Guarda la serie en tu almacén de datos y consérvala todo el tiempo que quieras.

Preguntas sobre API de analíticas, respondidas

¿De dónde salen los números?

FoPost lee las analíticas de cada red con las credenciales de la cuenta conectada y normaliza los nombres de los campos. Las cifras coinciden con lo que la red muestra en su propio panel.

¿Qué tan recientes son los datos?

Las métricas se actualizan de forma programada en cada cuenta conectada. Una publicación de hoy muestra las primeras cifras en cuestión de horas y se estabiliza cuando la red cierra sus recuentos.

¿Todas las redes informan las mismas métricas?

El conjunto básico de impresiones, interacciones y seguidores es común. Las métricas que una red no expone se devuelven como null y no como cero, para que distingas lo ausente de lo vacío.

¿Puedo obtener métricas de publicaciones hechas fuera de la API?

Sí. Cualquier publicación hecha desde la cuenta conectada se sigue a nivel de cuenta, y las publicaciones creadas en el panel tienen id como cualquier otra.

¿Qué scope necesito?

El scope analytics. Una clave que solo tenga ese scope es de solo lectura y no puede publicar, editar ni gestionar cuentas.

¿Hay un límite de frecuencia?

Sí, 100 solicitudes por minuto por clave. Agrupa las lecturas con rangos de fechas en lugar de hacer una llamada por día.

Empieza hoy a construir con la API de analíticas

Empezar es gratis y la API completa está incluida. Crea una clave y haz tu primera llamada en minutos.

Consigue tu clave de API