Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Insights de Stories de Instagram mediante la API

El endpoint de insights de medios de Instagram devuelve estas métricas de una Story mientras está activa: alcance, vistas, respuestas, compartidos, navegación, seguimientos, profile_visits, profile_activity, reposts y total_interactions. navigation se desglosa por story_navigation_action_type en TAP_FORWARD, TAP_BACK, TAP_EXIT y SWIPE_FORWARD. Las métricas de Story están disponibles durante 24 horas, los valores menores de 5 devuelven el error 10, y Instagram Login no tiene webhook story_insights.

easyCoexistence lee los insights de una Story con get_social_insights mientras está activa, así que Claude, ChatGPT o tu propio código pueden preguntar cómo les fueron las Stories de hoy y obtener alcance, vistas, respuestas, compartidos y navegación directamente de Meta para la cuenta conectada.

24 hours

Cuánto tiempo están disponibles por la API las métricas de contenido de Story.

Error 10

Se devuelve en lugar de un valor cuando una métrica de Story es menor que 5: no hay suficientes espectadores para que el contenido muestre insights.

Facebook Login

La única configuración que la guía de insights de Meta indica para el webhook story_insights; no es compatible con Instagram Login.

0

El valor de respuestas de una Story creada por una cuenta en Europa o Japón.

22 Jun 2026

Cuando Meta añadió link_clicks para Stories, que cuenta los toques en enlaces como los stickers de enlace, solo para Facebook Login.

¿Qué métricas devuelve una Story?

Las que la referencia de insights de medios de Meta lista para media_product_type STORY, leídas con GET /<STORY_MEDIA_ID>/insights mientras la Story está activa. Con Instagram Login la llamada va a graph.instagram.com con un token que tenga instagram_business_basic e instagram_business_manage_insights, y period es siempre lifetime:

reachUnique accounts that saw the Story. Estimated.
viewsTimes the Story was played on Instagram. In development.
repliesReplies to the Story, with regional exceptions.
sharesTimes the Story was shared.
navigationActions taken from the Story: forward, back, exit and next Story.
followsFollows of the account, counted for the Story.
profile_visitsTimes the profile was visited.
profile_activityActions on the profile after engaging, by action_type.
repostsReposts, minus reposts later deleted.
total_interactionsInteractions on the Story, net of removals. In development.
facebook_viewsPlays where the Story was crossposted. Throws if it was not.

¿Cómo se lee la navegación por acción?

Pide navigation por separado con breakdown=story_navigation_action_type. El total llega en total_value.value y cada acción en total_value.breakdowns[].results, que suman ese total: TAP_FORWARD (Adelante), TAP_BACK (Atrás), TAP_EXIT (Salir) y SWIPE_FORWARD (Siguiente Story). La respuesta de ejemplo de Meta escribe los valores en minúsculas:

Navigation broken down by action, after Meta's sample
GET https://graph.instagram.com/<STORY_MEDIA_ID>/insights
  ?metric=navigation
  &breakdown=story_navigation_action_type
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{
  "data": [
    {
      "name": "navigation",
      "period": "lifetime",
      "values": [{ "value": 25 }],
      "total_value": {
        "value": 25,
        "breakdowns": [
          {
            "dimension_keys": ["story_navigation_action_type"],
            "results": [
              { "dimension_values": ["tap_forward"], "value": 19 },
              { "dimension_values": ["tap_back"], "value": 4 },
              { "dimension_values": ["tap_exit"], "value": 1 },
              { "dimension_values": ["swipe_forward"], "value": 1 }
            ]
          }
        ]
      },
      "id": "<STORY_MEDIA_ID>/insights/navigation/lifetime"
    }
  ]
}

¿Cuánto tiempo están disponibles las métricas de Story?

24 horas. Meta solo hace disponibles las métricas de contenido de Story durante 24 horas, es decir, el tiempo que la Story está activa, aunque los datos que hay detrás pueden tardar hasta 48 horas. Léelas con un programa mientras la Story está activa y conserva los últimos valores que obtuviste. Meta indica que los datos pueden seguir llegando después de que expire la Story si se añade a un destacado, y que las llamadas a la API, los webhooks y la app pueden entonces mostrar resultados distintos.

¿Por qué una métrica de Story devuelve el error 10?

Porque su valor es menor que 5. Meta devuelve el código de error 10 con el mensaje (#10) Not enough viewers for the media to show insights en lugar de un número pequeño, así que una Story vista por pocas personas puede fallar mientras otra más vista funciona. Trátalo como un recuento bajo y no como una caída, y no lo reintentes en bucle.

¿Por qué las respuestas de una Story son 0?

Por normas regionales. Las respuestas de personas en Europa, desde el 1 de diciembre de 2020, y en Japón, desde el 14 de abril de 2021, quedan fuera de la métrica de respuestas, y una Story creada por una cuenta de una de esas regiones devuelve 0. La referencia de Meta define las respuestas como comentarios de IG sobre el objeto de media de la Story.

¿Existe un webhook story_insights?

No con Instagram Login. La tabla de campos de Meta marca story_insights como no disponible ahí, su referencia de insights de medios dice que el webhook de insights no es compatible con Instagram Login, y su guía de insights solo lista story_insights para Facebook Login. Con Facebook Login el campo se activa cuando expira una Story, incluye solo sus primeras 24 horas de métricas y devuelve como -1 los recuentos menores de 5.

¿Qué métricas de Story están retiradas o limitadas?

Algunos nombres siguen apareciendo en código antiguo o en el changelog de Meta:

  • impressions: obsoleta para contenido creado después del 2 de julio de 2024, así que una Story actual devuelve vistas en su lugar.
  • taps_forward, taps_back y exits: retiradas el 11 de diciembre de 2023; navigation, desglosada por story_navigation_action_type, devuelve las mismas acciones.
  • link_clicks: toques en enlaces como los stickers de enlace, añadida el 22 de junio de 2026 solo para Facebook Login.
  • total_views: vistas en todas las superficies, incluido el contenido promocionado, disponible solo con Facebook Login.

¿Cómo lee get_social_insights una Story?

Con el ID de media de la Story como object_id, que publish_instagram_post devuelve como media_id al publicar la Story, y las métricas como lista. Pide navigation en una llamada aparte con params configurado como breakdown story_navigation_action_type, porque un breakdown que una métrica pedida no admite hace fallar la llamada completa. Los errores de Meta, incluido el error 10, llegan tal como Meta los escribió.

get_social_insights arguments for one Story
{
  "account_id": "<ACCOUNT_ID>",
  "object_id": "<STORY_MEDIA_ID>",
  "metrics": ["reach", "views", "replies", "shares", "follows", "profile_visits"]
}

Errores comunes

  • Leer las métricas de una Story al día siguiente. Meta las hace disponibles solo durante 24 horas, así que recógelas mientras la Story está activa.
  • Reintentar el error 10 en bucle. Significa un valor menor que 5, es decir, pocos espectadores, y no cambiará hasta que más personas vean la Story.
  • Pedir navigation con un breakdown junto a otras métricas. story_navigation_action_type funciona solo con navigation, y un breakdown no admitido hace fallar la llamada completa.
  • Esperar story_insights con Instagram Login. Meta no ofrece ese webhook ahí, así que consulta el endpoint de insights antes de que expire la Story.
Hacerlo con EasyCoexistence

Las Stories se publican con publish_instagram_post. De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿Cambian los insights de una Story después de añadirla a un destacado?

Pueden cambiar. Meta indica que una Story añadida a un destacado puede seguir recibiendo datos después de expirar, así que la API, los webhooks y la app pueden no coincidir durante un tiempo.

¿Funciona total_views en Stories con Instagram Login?

No. total_views, que cuenta las vistas en todas las superficies e incluye el contenido promocionado, está disponible solo con Facebook Login; con Instagram Login, pide views.

¿Puede la API leer los clics en stickers de enlace de una Story de Instagram?

Solo con Facebook Login. Meta añadió link_clicks para Stories el 22 de junio de 2026, que cuenta los toques en enlaces como los stickers de enlace, y no lo ofrece con Instagram Login.

¿Qué sustituyó a taps_forward, taps_back y exits?

navigation, desglosada por story_navigation_action_type en TAP_FORWARD, TAP_BACK, TAP_EXIT y SWIPE_FORWARD. Las métricas antiguas se retiraron el 11 de diciembre de 2023.

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