Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Recuento de seguidores y campos de perfil de Instagram mediante la API

La API de Instagram devuelve el recuento de seguidores de una cuenta profesional en el campo followers_count, junto a follows_count, media_count, username, name, profile_picture_url y account_type. Con Instagram Login, GET /me con esos campos los lee en graph.instagram.com usando instagram_business_basic. La referencia de IG User de Meta también lista biography y website, y los cambios de seguidores a lo largo del tiempo llegan desde insights.

easyCoexistence conecta una cuenta de Instagram Business o de creador con Instagram Login, para que Claude, ChatGPT o tu propio código lean su alcance, vistas y seguidos mediante get_social_insights, con la API oficial de Meta; los recuentos de seguidores y publicaciones del perfil no tienen herramienta.

followers_count

Número total de usuarios de Instagram que siguen a la cuenta, un campo que la referencia de IG User de Meta marca como public.

9 fields

Los campos de User que lista la guía de Instagram Login de Meta, desde id y user_id hasta followers_count y media_count.

Media_Creator

El valor de account_type para una cuenta de creador; una cuenta de empresa devuelve Business.

100 followers

Por debajo de este umbral, Meta no devuelve los insights follows_and_unfollows ni follower_count para la cuenta.

¿Qué campos de perfil devuelve Instagram Login?

Los nueve campos que la guía de Instagram Login de Meta lista para el objeto User, leídos con GET /me y una lista de fields. El token necesita instagram_business_basic, y para las llamadas siguientes el IG_ID de la cuenta es user_id, no id:

idThe app user's app-scoped ID
user_idThe professional account's ID, the id in its webhook notifications
usernameThe account's username
nameThe profile name
account_typeBusiness or Media_Creator
profile_picture_urlThe profile picture's URL
followers_countAccounts following it
follows_countAccounts it follows
media_countMedia published on the account

¿Cómo se lee el recuento de seguidores?

Pide followers_count en /me, que la referencia de Meta traduce al nodo User de la cuenta detrás del token. El valor es un total acumulado en el momento de la llamada, así que un panel que lo grafique tiene que guardar una lectura cada día por su cuenta.

Counts and username with Instagram Login
GET https://graph.instagram.com/me
  ?fields=user_id,username,followers_count,follows_count,media_count
  &access_token=<ACCESS_TOKEN>

{
  "user_id": "<IG_ID>",
  "username": "<USERNAME>",
  "followers_count": 1840,
  "follows_count": 312,
  "media_count": 97
}

¿Qué otros campos lista la referencia de Meta?

La referencia de IG User de Meta, escrita para las tres configuraciones a la vez, añade campos más allá de los nueve de la guía de Instagram Login. Marca algunos como disponibles para cuentas vinculadas a una Página de Facebook y deja el resto sin nota de login:

  • biography: el texto de la biografía del perfil, marcado como public.
  • website: la URL del sitio web de la cuenta, marcado como public.
  • has_profile_pic: si la cuenta tiene foto de perfil.
  • is_published y legacy_instagram_user_id: para cuentas vinculadas a una Página, el segundo es el ID creado para los endpoints de Marketing API hasta la v21.0.
  • shopping_product_tag_eligibility: si la cuenta tiene configurado un Instagram Shop.

¿Cómo se sigue el crecimiento de seguidores?

A través de los insights de la cuenta y no del perfil. GET /<IG_ID>/insights con metric=follows_and_unfollows, metric_type=total_value y el desglose follow_type devuelve las cuentas que siguieron y las que dejaron de seguir o salieron de Instagram. Con Instagram Login, el token también necesita instagram_business_manage_insights. Meta devuelve este dato, y follower_count, solo para cuentas con al menos 100 seguidores.

¿La API puede listar quiénes son los seguidores?

No. La referencia de IG User de Meta da followers_count y follows_count como números y no lista ninguna arista que devuelva las cuentas detrás de ellos. Lo que sí ofrece es follower_demographics en los insights de la cuenta, desglosado por edad, ciudad, país o género, para cuentas con al menos 100 seguidores.

¿Se puede leer el recuento de seguidores de otra cuenta?

Con Business Discovery, que Meta ofrece con Facebook Login y Unified Login: GET /<IG_ID>?fields=business_discovery.username(<USERNAME>){followers_count,media_count} los devuelve para otra cuenta de empresa o de creador. Lee los campos públicos de la otra cuenta que la referencia de IG User marca, entre ellos biography, followers_count, id, media_count, username y website.

¿Cómo se lee el perfil a través de easyCoexistence?

list_social_accounts devuelve el username, name y external_id de cada cuenta conectada, que es su IG_ID. Los recuentos del perfil, followers_count, follows_count y media_count, no tienen herramienta, y los tokens de Instagram no se entregan; get_social_insights lee en su lugar cómo se mueve la audiencia, con follows_and_unfollows, reach y views.

Errores comunes

  • Esperar una lista de seguidores. Meta devuelve recuentos y, desde 100 seguidores, datos demográficos, pero no las cuentas en sí.
  • Graficar el crecimiento solo con followers_count. Es un total acumulado; follows_and_unfollows en insights separa los nuevos seguidores de los que dejaron de seguir.
  • Comprobar account_type buscando CREATOR. Una cuenta de creador devuelve Media_Creator, y una cuenta de empresa, Business.
  • Usar el id de /me como ID de la cuenta. La guía de Meta vincula user_id, no id, a las notificaciones de webhook y a rutas como /<IG_ID>/media.
Hacerlo con EasyCoexistence

Desde US$ 9 hasta US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿La API de Instagram devuelve la biografía del perfil?

Sí, como biography, que la referencia de IG User de Meta marca como pública. Los nueve campos de User de la guía de Instagram Login lo dejan fuera, así que solicítalo en GET /me y comprueba la respuesta en tu configuración.

¿Por qué follows_and_unfollows no devuelve nada?

Meta no lo devuelve para cuentas con menos de 100 seguidores.

¿Puedo obtener el recuento de seguidores de una cuenta personal?

No. La API de Meta sirve cuentas profesionales, y Business Discovery lee solo cuentas de empresa y de creador.

¿Qué permiso necesita el recuento de seguidores?

Con Instagram Login, instagram_business_basic. Los insights de seguidores añaden instagram_business_manage_insights.

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