Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Demografía de seguidores de Instagram mediante la API

El endpoint de insights de cuentas de Instagram devuelve la demografía de seguidores con metric=follower_demographics, period=lifetime, metric_type=total_value, un parámetro timeframe y un desglose por edad, género, ciudad o país. engaged_audience_demographics hace lo mismo para las cuentas que interactuaron con el contenido. Meta devuelve solo los 45 valores principales; los datos de seguidores requieren 100 seguidores, y los de audiencia con interacción, 100 interacciones en el intervalo.

easyCoexistence lee los datos demográficos de seguidores y de la audiencia con interacción de Instagram con get_social_insights, para que Claude, ChatGPT o tu propio código pregunten qué países, ciudades o grupos de edad siguen la cuenta y obtengan los números de Meta para la cuenta conectada.

100 followers

Por debajo de esto, follower_demographics no se devuelve para la cuenta.

100 engagements

Interacciones necesarias en el intervalo para que se devuelva engaged_audience_demographics.

Top 45

Las métricas demográficas devuelven solo los 45 resultados principales, así que las ciudades y países más pequeños quedan fuera.

19 Aug 2024

Cuándo dejaron de funcionar last_14_days, last_30_days, last_90_days y prev_month para engaged_audience_demographics en todas las versiones.

48 hours

Cuánto puede retrasarse el dato detrás de las métricas de la cuenta.

¿Qué métricas demográficas hay?

Dos en la referencia de insights de cuenta de Meta, ambas leídas con GET /<IG_ID>/insights, y dos conjuntos antiguos que el código viejo todavía solicita:

  • follower_demographics: las características demográficas de los seguidores de la cuenta.
  • engaged_audience_demographics: lo mismo para la audiencia con interacción, es decir, las cuentas que interactuaron con su contenido.
  • Ambas: period lifetime, metric_type total_value, un timeframe y un desglose por edad, ciudad, país o género.
  • audience_gender_age, audience_locale, audience_country y audience_city: retiradas el 11 de diciembre de 2023.
  • reached_audience_demographics: mencionada en el changelog de 2024 de Meta, pero ausente de su tabla actual de métricas.

¿Cómo se piden los datos demográficos de seguidores?

Con la métrica, period=lifetime, metric_type=total_value, un timeframe y un solo desglose. timeframe reemplaza a since y until, que las métricas demográficas no admiten, y es obligatorio. Con Instagram Login el token necesita instagram_business_basic e instagram_business_manage_insights, y la llamada va a graph.instagram.com:

Followers by country, this month
GET https://graph.instagram.com/<IG_ID>/insights
  ?metric=follower_demographics
  &period=lifetime
  &timeframe=this_month
  &breakdown=country
  &metric_type=total_value
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

¿Cómo es la respuesta?

Los conteos están en total_value.breakdowns. dimension_keys indica el intervalo y el desglose pedidos, y cada resultado combina dimension_values, el intervalo y un valor del desglose, con un conteo. El ejemplo de Meta, para la audiencia con interacción por país, devuelve los países como códigos de dos letras, como US y ES:

The response shape, broken down by country
{
  "data": [
    {
      "name": "follower_demographics",
      "period": "lifetime",
      "title": "<TITLE>",
      "description": "<DESCRIPTION>",
      "total_value": {
        "breakdowns": [
          {
            "dimension_keys": ["timeframe", "country"],
            "results": [
              { "dimension_values": ["<TIMEFRAME>", "<COUNTRY_CODE>"], "value": <COUNT> },
              { "dimension_values": ["<TIMEFRAME>", "<COUNTRY_CODE>"], "value": <COUNT> }
            ]
          }
        ]
      },
      "id": "<IG_ID>/insights/follower_demographics/lifetime"
    }
  ]
}

¿Qué intervalos funcionan?

La referencia de Meta enumera last_14_days, last_30_days, last_90_days, prev_month, this_month y this_week para ambas métricas y, para la audiencia con interacción, describe this_month como los últimos 30 días y this_week como los últimos 7. Para engaged_audience_demographics los primeros cuatro dejaron de funcionar desde v20.0 y en todas las versiones el 19 de agosto de 2024, así que usa this_week o this_month. Esa entrada del changelog no menciona follower_demographics.

¿Qué umbrales y límites se aplican?

La referencia de insights de cuenta de Meta fija estas reglas para las métricas demográficas:

  • follower_demographics no se devuelve para una cuenta con menos de 100 seguidores.
  • engaged_audience_demographics no se devuelve con menos de 100 interacciones en el intervalo.
  • Solo vuelven los 45 resultados principales, así que las ciudades y países más pequeños quedan fuera.
  • Solo se cuentan los espectadores con datos demográficos, así que los valores pueden sumar menos que el número de seguidores.
  • Los datos que faltan devuelven un conjunto vacío, no 0, y pueden retrasarse hasta 48 horas.
  • Un desglose que una métrica pedida no admite hace fallar toda la llamada con An unknown error has occurred.

¿Funcionan los datos demográficos con Instagram Login?

Sí. Meta abrió los insights de cuenta y de contenido a las apps de Instagram Login el 21 de enero de 2025, y su referencia de insights de cuenta incluye Instagram Login con los permisos instagram_business_basic e instagram_business_manage_insights y graph.instagram.com como host. La cuenta tiene que ser profesional o de creador, como exige la Plataforma de Instagram de Meta.

¿Cómo lee get_social_insights los datos demográficos?

Con metrics en follower_demographics o engaged_audience_demographics, period en lifetime y params con timeframe, breakdown y metric_type. easyCoexistence llama a GET /<IG_ID>/insights para la cuenta conectada con su token y devuelve la respuesta de Meta, para que Claude o ChatGPT puedan decir qué países, ciudades o grupos de edad siguen la cuenta.

get_social_insights arguments for followers by age
{
  "account_id": "<ACCOUNT_ID>",
  "metrics": ["follower_demographics"],
  "period": "lifetime",
  "params": {
    "timeframe": "this_month",
    "breakdown": "age",
    "metric_type": "total_value"
  }
}

Errores comunes

  • Pasar since y until. Las métricas demográficas no los admiten: timeframe fija el rango, y es obligatorio.
  • Usar last_30_days o last_90_days para la audiencia con interacción. Esos intervalos dejaron de funcionar para engaged_audience_demographics en todas las versiones el 19 de agosto de 2024.
  • Sumar un desglose para obtener el número de seguidores. Solo se cuentan los espectadores con datos demográficos y solo vuelven los 45 valores principales, así que la suma queda corta.
  • Esperar datos de una cuenta pequeña. Los datos demográficos de seguidores requieren 100 seguidores, y la audiencia con interacción, 100 interacciones en el intervalo.
Hacerlo con EasyCoexistence

De US$ 9 a US$ 0.75 por número conectado al mes, bajando a medida que añades números, con los primeros 3 días gratis.

Preguntas frecuentes

¿Cuántos seguidores necesita una cuenta de Instagram para ver datos demográficos?

100. Por debajo de eso, Meta no devuelve follower_demographics; engaged_audience_demographics necesita 100 interacciones en el intervalo.

¿Por qué Instagram devuelve solo 45 ciudades?

Las métricas demográficas de Meta devuelven solo los 45 resultados principales, así que las ciudades y países más pequeños quedan fuera.

¿Qué reemplazó a audience_gender_age en la API de Instagram?

follower_demographics, con un desglose por edad, género, ciudad o país. Meta retiró audience_gender_age, audience_locale, audience_country y audience_city el 11 de diciembre de 2023.

¿Puedo usar since y until con follower_demographics?

No. Las métricas demográficas no admiten since ni until; en su lugar, el parámetro timeframe fija el rango, y es obligatorio.

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