Referencia · APIs de redes sociales para desarrolladores

API de analíticas de redes sociales: las métricas que puedes obtener de verdad

Por Antoine Blanco··7 min de lectura

Cada plataforma expone métricas distintas, en ventanas distintas, con definiciones distintas. Instagram da reach y views, TikTok no da reach, YouTube devuelve totales acumulados, LinkedIn guarda 12 meses. Una API de analíticas de redes sociales es sobre todo el trabajo de reconciliar eso. Esto es lo que devuelve de verdad cada plataforma, verificado el 21 de octubre de 2026.

Qué devuelve una API de analíticas y qué no devolverá nunca

Tres cosas son ciertas en todas las API de plataforma de esta lista. Devuelven recuentos, no razones. Devuelven tu propio contenido, no el de tu competencia. Y devuelven lo que la plataforma decidió calcular, que rara vez es lo que tú habrías calculado.

El último punto es el que cuesta semanas. No existe una definición compartida de view, impression o reach entre estas API. Instagram etiqueta reach y accounts_engaged como estimadas. YouTube no tiene ninguna métrica llamada impressions, solo adImpressions para publicidad más las impresiones de anotaciones y tarjetas. LinkedIn te da impressionCount y uniqueImpressionsCount, que son dos ideas distintas con nombres parecidos. Cualquier total multiplataforma que construyas es una opinión, y deberías dejar esa opinión escrita en algún sitio donde tu yo futuro la encuentre.

API de analíticas de Instagram: impressions desapareció, views ocupó su lugar

Si estás migrando una integración antigua, este es el cambio que rompe. En la referencia de insights de usuario de Instagram, impressions aparece como obsoleta, para la v22.0 y después para todas las versiones desde el 21 de abril de 2025. La métrica que lleva la misma intención ahora es views, descrito como el número de veces que tu contenido se reprodujo o se mostró.

Lo que te da hoy el endpoint a nivel de cuenta: views, reach, accounts_engaged, total_interactions, likes, comments, shares, saves, replies, reposts, follows_and_unfollows, profile_links_taps, más follower_demographics y engaged_audience_demographics por edad, ciudad, país o género.

Los límites importan más que la lista:

Esa última pareja es la razón de que tus gráficas tengan agujeros en vez de líneas planas. Para el resto de la superficie de Instagram, mira la Instagram Graph API en 2026.

Qué expone cada plataforma

Las capacidades por plataforma de abajo son las que lee el recolector de PlugKit, verificadas en docs.plugkit.co el 21 de octubre de 2026 y cruzadas con la referencia de cada plataforma donde es pública.

Plataforma Métricas de publicación disponibles Reach o impressions Historial de seguidores Detecta publicaciones hechas en otro sitio
Instagram views, likes, comentarios, compartidos, guardados reach (estimado) sí sí
Facebook impressions, clics, likes, comentarios, compartidos impressions y reach sí sí
TikTok views, likes, comentarios, compartidos sin reach sí sí
YouTube views, likes, comentarios sin métrica de impressions sí sí
X likes, respuestas, reposts impressions sí no
LinkedIn clics, likes, comentarios, compartidos impressionCount y uniqueImpressionsCount sí sí
WhatsApp, Telegram ninguna, no hay publicaciones ninguno ninguno ninguno

Detrás de esa tabla se esconden cuatro detalles.

YouTube devuelve totales acumulados, no una serie diaria. La lista de métricas de YouTube Analytics es larga, con estimatedMinutesWatched, averageViewDuration, audienceWatchRatio y métricas de ingresos, pero conseguir el desglose diario exige una auditoría de Google aparte. Sin eso recibes un número acumulado y tienes que derivarlo tú.

TikTok necesita scopes que no se aplican de forma retroactiva. video.list y user.info.stats son obligatorios, y una cuenta conectada antes de que los pidieras muestra gráficas vacías hasta que la persona vuelva a conectar.

LinkedIn guarda 12 meses móviles y solo lo orgánico. El endpoint de estadísticas de publicaciones de organización devuelve datos de los últimos 12 meses, con granularidad DAY o MONTH, y no cuenta actividad patrocinada. Las estadísticas de por vida salen de omitir timeIntervals; las consultas por publicación no admiten estadísticas con límite temporal en absoluto. Una nota de calendario: la versión Marketing 202511 está anunciada para apagarse el 16 de noviembre de 2026, así que fija una versión actual.

X cobra por lectura. Es la única plataforma aquí donde sacar analíticas tiene una línea de factura. PlugKit repercute las llamadas a coste, $0.005 por leer un post y $0.010 por leer un usuario, con un tope de gasto por defecto de $20 al mes en cada cuenta hasta que fijes el tuyo. Su documentación sitúa una cuenta de X consultada cada hora hasta en $360 al mes, que es el orden de magnitud correcto antes de construir un dashboard al minuto. Los rate limits detrás de todo esto están recogidos en rate limits de las APIs de redes sociales.

Por qué dos herramientas nunca muestran el mismo número

API de analíticas multiplataforma: construir o comprar

Construirla significa un flujo OAuth y un vocabulario de métricas por plataforma, un poller por edad de contenido, un almacén, y una historia de backfill que en realidad no puedes cumplir, porque el historial de seguidores empieza el día en que se conecta una cuenta y nadie puede rellenarlo después.

Comprarla significa aceptar la cadencia de recogida de otro. La de PlugKit está publicada, y esa es la parte que merece copiarse: nuevas publicaciones descubiertas cada 6 horas en Creator y cada 90 minutos en Pro; publicaciones de menos de 48 horas refrescadas cada hora en Creator y cada 30 minutos en Pro; las de menos de 30 días cada 6 horas o cada hora; las más antiguas una vez por semana; recuento de seguidores a diario; todo lo que pasa de 180 días congelado en su última lectura. El historial legible es de 90 días en Creator y 550 en Pro, y como los datos se registran sea cual sea el plan, subir de plan revela un historial que ya tenías.

Los endpoints de lectura son /v1/analytics/summary, /posts, /timeseries, /platforms, /best-times, /accumulation y /followers, y ninguno de ellos llama a una plataforma en el momento de la petición. Cada respuesta incluye lastSyncAt y nextSyncAt, así puedes mostrar la antigüedad de los datos en vez de fingir que vas en directo. POST /v1/analytics/sync fuerza un refresco, y las llamadas repetidas sobre la misma cuenta en menos de 15 segundos se ignoran.

Las analíticas están incluidas en todos los planes y en los 7 días gratis sin tarjeta, con una cuenta conectada durante la prueba. Las llamadas de pago a X siguen bloqueadas durante la prueba, que es el valor por defecto sensato. PlugKit cuesta $49 al mes por 5 cuentas conectadas, cancelas cuando quieras. Si solo necesitas publicar, sin números, la comparativa de la guía de las API de redes sociales es el mejor punto de partida, y si lo que de verdad quieres son los DM y los comentarios en un solo sitio, eso es una bandeja de entrada de redes sociales, no una API de analíticas.

Preguntas frecuentes

¿Existe una sola API para todas las analíticas de redes sociales?

Desde las plataformas, no. Cada una lleva su propia API, nombres de métricas y ventanas. Una API de analíticas unificada siempre es una capa encima que normaliza esas diferencias, y esa normalización es un criterio que deberías poder inspeccionar.

¿La API de analíticas de Instagram sigue devolviendo impressions?

No. impressions está obsoleta, para la v22.0 y después para todas las versiones desde el 21 de abril de 2025. Usa views. Reach sigue ahí y lleva la etiqueta de estimado puesta por Instagram.

¿Cuánto atrás puedo sacar métricas de redes sociales?

Depende de la plataforma y de la herramienta. Las estadísticas de publicaciones de LinkedIn cubren 12 meses móviles. Los insights de cuenta de Instagram se conservan unos 90 días. El historial de seguidores solo puede empezar el día en que se conectó una cuenta, así que conecta las cuentas antes de necesitar el historial.

¿Por qué mis números de la API difieren de los números de la app?

Porque se leyeron en un momento distinto, y porque algunas métricas se asientan durante unas 24 horas después de publicar. Mira la marca de tiempo de sincronización en la respuesta antes de tratar una diferencia como un bug.

¿Puede un agente de IA leer estas métricas directamente?

Sí, si le das las herramientas. A través de un servidor MCP las lecturas de analíticas se convierten en herramientas que el agente llama, así que una pregunta como la mejor hora para publicar por cuenta se responde desde los mismos endpoints. El compromiso entre darle a un agente herramientas MCP o una API REST está en MCP o API REST para tu agente.

AB
Antoine BlancoFundador de PlugKit. Gestiona sus propias cuentas de Instagram, YouTube y X a través de la API y del servidor MCP que se describen aquí.

Un solo plug para cada plataforma que toca tu agente

49 $ al mes por 5 cuentas conectadas, cancela cuando quieras. Todas las funciones en todos los planes.

Consigue tu clave de API →
Español ▾