Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Estadísticas de Instagram a través de la API: métricas de cuenta y de publicaciones

La API de Instagram devuelve estadísticas de una cuenta profesional y de cada una de sus publicaciones, Reels e historias. Las métricas de cuenta incluyen alcance, visualizaciones, cuentas que interactuaron, seguimientos y dejadas de seguir, me gusta, comentarios, guardados y veces compartido; las de publicación incluyen alcance, visualizaciones, me gusta, comentarios, guardados y veces compartido. Meta indica que los datos pueden llegar con hasta 48 horas de retraso.

easyCoexistence lee las estadísticas de Instagram con get_social_insights, así que puedes preguntar a Claude o ChatGPT qué tal funcionaron las publicaciones de la semana pasada y obtener alcance, visualizaciones, me gusta, comentarios, guardados y veces compartido directamente de Meta, de la cuenta o de una sola publicación.

48 hours

Cuánto tiempo pueden retrasarse los datos de las métricas de Instagram.

100 followers

Por debajo de esta cifra, la API no devuelve los seguimientos y dejadas de seguir ni los datos demográficos de los seguidores de la cuenta.

2 years

Cuánto tiempo almacena Meta las métricas de contenido.

24 hours

Cuánto tiempo siguen disponibles las métricas de historias a través de la API.

21 Apr 2025

Cuándo dejó de funcionar impressions en todas las versiones de la API, salvo en contenido creado antes del 2 de julio de 2024; la sustituyó views.

¿Qué métricas de cuenta están disponibles?

Se leen con GET /<IG_ID>/insights, en su mayoría con period=day y metric_type=total_value:

  • reach: cuentas únicas que vieron el contenido, anuncios incluidos; es una estimación.
  • views: veces que el contenido se reprodujo o se mostró.
  • accounts_engaged: cuentas que interactuaron con el contenido, anuncios incluidos; es una estimación.
  • follows_and_unfollows: seguimientos y dejadas de seguir en el periodo; requiere al menos 100 seguidores.
  • likes, comments, saves, shares, replies y reposts, además de total_interactions.
  • profile_links_taps: toques en los botones de dirección del negocio, llamada, correo electrónico y mensaje de texto.
  • follower_demographics y engaged_audience_demographics: edad, ciudad, país y género.

¿Qué métricas de publicación están disponibles?

Se leen con GET /<IG_MEDIA_ID>/insights; las métricas que se aplican dependen del formato. En una publicación o un Reel, los me gusta, los comentarios, las visualizaciones y el total de interacciones cuentan solo la actividad orgánica, no la interacción con los anuncios creados a partir de ese contenido.

  • Publicaciones y Reels: reach, views, likes, comments, saved, shares, total_interactions y reposts.
  • Solo Reels: ig_reels_avg_watch_time, ig_reels_video_view_total_time y reels_skip_rate.
  • Publicaciones e historias: follows, profile_visits y profile_activity.
  • Historias: reach, views, shares, replies, navigation, reposts y total_interactions.

¿Cómo funcionan period, metric_type y los desgloses?

Las métricas de cuenta usan period=day. metric_type=total_value devuelve una sola cifra para todo el rango y es el que exigen los desgloses; time_series devuelve un valor por día y está disponible para reach. Los desgloses dividen un total por media_product_type (publicaciones, carruseles, Reels, historias y anuncios), por follow_type (seguidores o no seguidores) o por contact_button_type.

Las métricas demográficas usan un timeframe, como this_week o this_month, en lugar de since y until; sin since ni until, las demás métricas abarcan las últimas 24 horas. Pedir un desglose que alguna de las métricas solicitadas no admite hace fallar toda la petición con un error desconocido.

¿Qué umbrales y retrasos se aplican?

Las reglas de Meta sobre cuándo aparece una cifra y cuánto tiempo sigue disponible:

  • Los datos pueden llegar con hasta 48 horas de retraso.
  • Las cuentas con menos de 100 seguidores no obtienen follows_and_unfollows ni follower_demographics; engaged_audience_demographics requiere 100 interacciones en el timeframe indicado.
  • Los datos que faltan o no están disponibles llegan como un conjunto vacío, no como 0.
  • Las métricas demográficas devuelven solo los 45 valores principales.
  • Las métricas de cuenta se guardan hasta 90 días; las de contenido, hasta 2 años.

¿Qué cambia en las historias y los carruseles?

Las métricas de historias solo están disponibles durante 24 horas, y un valor inferior a 5 devuelve el código de error 10 (no hay suficientes espectadores) en lugar de una cifra. Las respuestas de personas de Europa y Japón no se incluyen, y una historia creada por una cuenta de esas regiones registra 0 respuestas. Con Instagram Login no existe el webhook story_insights, así que las cifras de una historia deben leerse mientras sigue publicada.

Un carrusel cuenta como una sola publicación: Meta no devuelve estadísticas de las fotos y los videos que contiene.

¿Por qué cambian los nombres de las métricas?

Porque Meta retira y renombra métricas entre versiones de la API. impressions quedó obsoleta en la v22.0 y dejó de funcionar en todas las versiones el 21 de abril de 2025, salvo en contenido creado antes del 2 de julio de 2024, y en su lugar se introdujo views; plays, clips_replays_count e ig_reels_aggregated_all_plays_count desaparecieron al mismo tiempo. video_views y varias series temporales de perfil, entre ellas profile_views, se eliminaron antes. Una petición con un nombre retirado falla, así que una lista de métricas escrita para una versión anterior de la API puede necesitar una actualización.

Errores comunes

  • Pedir impressions. Ya no funciona en ninguna versión de la API; pide views en su lugar.
  • Tomar un resultado vacío como cero. Meta devuelve un conjunto de datos vacío cuando una métrica no está disponible, y eso no equivale a que no haya habido actividad.
  • Leer las métricas de una historia cuando ya terminó. Solo están disponibles durante 24 horas.
  • Añadir un desglose a una petición de varias métricas. Si alguna no lo admite, falla toda la llamada.
Hacerlo con EasyCoexistence

De US$ 9 a US$ 0.75 por conexión al mes, un precio que baja a medida que añades conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿Qué sustituyó a impressions en la API de Instagram?

views, que cuenta las veces que el contenido se reprodujo o se mostró. Meta retiró impressions en todas las versiones de la API el 21 de abril de 2025, salvo en contenido creado antes del 2 de julio de 2024.

¿Por qué mi cuenta no devuelve datos de seguidores?

Meta no devuelve follows_and_unfollows ni los datos demográficos de seguidores en cuentas con menos de 100 seguidores.

¿Cuánto historial de estadísticas de Instagram puedo consultar?

Hasta 90 días de métricas de cuenta y hasta 2 años de métricas de contenido; online_followers solo cubre los últimos 30 días.

¿Las cifras incluyen anuncios?

En parte. El alcance y las cuentas que interactuaron de una cuenta incluyen anuncios, mientras que los me gusta, los comentarios y las visualizaciones de una publicación cuentan solo la actividad orgánica.

Sigue leyendo

Conecta tu primer canal en dos minutos.

Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.

  • 3 días gratis
  • Cancela cuando quieras
  • Solo APIs oficiales
  • Monitorizado 24/7

Verificado el