API de Perfil por ID numérico de Instagram

Lee el username actual y los datos de perfil de una cuenta de Instagram a partir de su user_id numérico: follower_count, following_count y post_count, por $0.56 por cada 1000 llamadas.

  • user_id no cambia si cambia el nombre de usuario
  • Sin recent_posts ni highlight_count
  • El author_id de una publicación sirve como user_id

Salud de la API

Salud 24 h
Normal
  • Saludable / normal
  • Disponible
  • Limitada
  • Casi sin servicio
Normal

Últimas 24 horas

Últimos 30 días

  1. 1Solicitud

    POST /api/v1/social
    {
      "platform": "instagram",
      "action": "profile_by_id",
      "params": {
        "user_id": "787132"
      }
    }
  2. 2Respuesta JSON

    {
      "results": {
        "username": "n•••o",
        "bio": "Step into wonder and find your inner explorer with National Geographic 🌎",
        "follower_count": 268002941,
        "following_count": 195,
        …
      }
    }
  3. 3Campos

    usernamebiofollower_countfollowing_count
    n•••oStep into wonder and find your inner explorer with National Geographic 🌎268002941195
  4. 4CSV

    instagram-profile_by_id-sample.csv username,display_name,bio,follower_count,following_count,post_count,is_private,is_verified,is_business,is_professional,category,external_url,avatar_url,user_id,avatar_hd_url,external_urls,has_reels,url,reels_count,business_email,business_phone,threads_username,fbid,is_memorialized,is_joined_recently,account_type,emails,phones,pronouns,bio_links_detail,messaging_ids,business_address,platform

La solicitud lleva el user_id numérico y devuelve un objeto JSON con username, bio, follower_count y más, listo como tabla de campos o CSV.

Qué datos obtienes

La tabla muestra una llamada real para 787132, capturada el 21 de noviembre de 2026, 07:18 (UTC), que devolvió un objeto. Las barras grises tapan datos personales que se quitaron (••• en el CSV). Tus llamadas devuelven los campos de la referencia de campos.

usernamedisplay_namebiofollower_countfollowing_countpost_countis_privateis_verifiedis_businessis_professionalcategoryexternal_urlavatar_urluser_idavatar_hd_urlexternal_urlshas_reelsurlreels_countbusiness_emailbusiness_phonethreads_usernamefbidis_memorializedis_joined_recentlyaccount_typeemailsphonespronounsbio_links_detailmessaging_idsbusiness_addressplatform
n•••oN•••cStep into wonder and find your inner explorer with National Geographic 🌎26800294119532196falsetruetruetruenullhttp://visitstore.bio/natgeo787132[{"url":"http://visitstore.bio/natgeo"},{"url":"https://ngmdomsubs.nationalgeographic.com/servlet/OrdersGateway?cds_mag_code=NGM&cds_page_id=283562&cds_response_key=I5FX10002","title":"Subscribe Here!"}]truehttps://www.instagram.com/natgeo/1nullnulln•••onullnullbusinessnullnullnull[{"url":"http://visitstore.bio/natgeo","type":"external"},{"url":"https://ngmdomsubs.nationalgeographic.com/servlet/OrdersGateway?cds_mag_code=NGM&cds_page_id=283562&cds_response_key=I5FX10002","title":"Subscribe Here!","type":"external"}]nullnullinstagram

Casos de uso

  • Encuentra una cuenta tras un cambio de nombre

    Si solo tienes un user_id antiguo, léelo para obtener el username actual aunque la cuenta cambiara de nombre.

  • Convierte el autor de una publicación en un nombre

    author_id en el resultado de una publicación es el user_id. Pásalo para obtener el username y el follower_count actuales del autor.

  • Sigue las cuentas por número

    Usa user_id como clave de la cuenta y lee username y bio cada vez para registrar cambios de nombre y de biografía.

  • Completa los datos de contacto

    Lee external_urls, bio_links_detail y business_email para completar los enlaces y los datos de contacto públicos de una cuenta.

Instagram Graph API frente a EveryInfra

Comparación entre la Graph API oficial de Instagram y profile_by_id de EveryInfra: identificador de cuenta, qué cuentas puedes leer y acceso.

AspectoInstagram Graph APIEveryInfra
Identificador de cuentaCampo id: "App-scoped User ID."user_id es el identificador numérico de la cuenta, como 787132. No cambia si cambia el nombre de usuario, y la llamada devuelve el username actual de la cuenta.
Qué cuentas"Get fields and edges on an Instagram Business or Creator Account."La cuenta que indica user_id. La respuesta incluye las marcas is_business, is_professional y account_type.
Acceso necesarioToken de acceso: "Required. App user’s User access token."Una clave de API de EveryInfra en la cabecera Authorization: Bearer. No hace falta iniciar sesión en Instagram ni un token de acceso de Instagram.

Las citas proceden de la documentación para desarrolladores de Meta (página IG User), comprobadas el 2026-11-22. Fuentes oficiales: IG User (actualizada el 2026-04-22)

Límites y detalles a tener en cuenta

  • user_id es obligatorio: el identificador numérico de la cuenta, como 787132.
  • El identificador sale del user_id de un resultado de profile o del author_id de un resultado de publicación.
  • Los campos coinciden con profile, pero no se incluyen recent_posts ni highlight_count.
  • Una llamada lee una cuenta y devuelve un objeto.

Precios

Cada llamada cuesta $0.000556, sea cual sea el número de campos, y lee una cuenta. Las llamadas fallidas y los resultados vacíos no se cobran.

LlamadasCosto
10,000$5.56
100,000$55.56
1,000,000$555.56

Los totales usan el precio de lista por llamada.

Ejemplos de código

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "instagram",
  "action": "profile_by_id",
  "params": {
    "user_id": "787132"
  }
}'

Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.

Referencia de API

Consulta los parámetros, los campos de respuesta, los errores y la facturación de profile_by_id, y copia la página o ábrela como Markdown para un asistente de IA.

POST

Prompt para IA

#
Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Instagram: Perfil por ID numérico (instagram/profile_by_id).

Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en instagram y action en profile_by_id, y los parámetros dentro de params.
- Parámetros obligatorios:
  - user_id: ID numérico de la cuenta de Instagram, como 787132; es el user_id de profile y el author_id de las publicaciones.
- Devuelve un objeto. Campos principales: username, display_name, bio, follower_count, following_count, post_count, is_private (Si la cuenta es privada), is_verified, is_business (Si la cuenta es una cuenta comercial), is_professional (Si la cuenta es profesional (comercial…), category, external_url (Enlace externo del perfil); 32 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=instagram.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "instagram",
  "action": "profile_by_id",
  "params": {
    "user_id": "787132"
  }
}
- Precio: $0.56 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.

Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.

Parámetros de la solicitud

#
NombreUbicaciónTipoObligatorioPor defectoDescripción
AuthorizationheaderstringSí-Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código.
platformbodystringSíinstagramIdentificador de la plataforma, valor fijo.
actionbodystringSíprofile_by_idIdentificador de la capacidad, valor fijo.
user_idbody.paramsstringSí-ID numérico de la cuenta de Instagram, como 787132; es el user_id de profile y el author_id de las publicaciones.

Ejemplo de respuesta

#
Obtenida el 21 de noviembre de 2026, 07:18 (UTC) llamando a esta API con los parámetros del ejemplo de código de arriba. results y count son la respuesta real de esa llamada, sin información personal (nombres, usuarios, avatares, enlaces de perfil, datos de contacto). id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.
json
{  "id": "req_…",  "platform": "instagram",  "action": "profile_by_id",  "results": {    "username": "n•••o",    "display_name": "N•••c",    "bio": "Step into wonder and find your inner explorer with National Geographic 🌎",    "follower_count": 268002941,    "following_count": 195,    "post_count": 32196,    "is_private": false,    "is_verified": true,    "is_business": true,    "is_professional": true,    "external_url": "http://visitstore.bio/natgeo",    "avatar_url": "https://scontent-fra5-1.cdninstagram.com/•••",    "user_id": "787132",    "avatar_hd_url": "https://scontent-fra5-1.cdninstagram.com/•••",    "external_urls": [      {        "url": "http://visitstore.bio/natgeo"      },      {        "url": "https://ngmdomsubs.nationalgeographic.com/servlet/OrdersGateway?cds_mag_code=NGM&cds_page_id=283562&cds_response_key=I5FX10002",        "title": "Subscribe Here!"      }    ],    "has_reels": true,    "url": "https://www.instagram.com/natgeo/",    "reels_count": 1,    "threads_username": "n•••o",    "fbid": "•••",    "account_type": "business",    "bio_links_detail": [      {        "url": "http://visitstore.bio/natgeo",        "type": "external"      },      {        "url": "https://ngmdomsubs.nationalgeographic.com/servlet/OrdersGateway?cds_mag_code=NGM&cds_page_id=283562&cds_response_key=I5FX10002",        "title": "Subscribe Here!",        "type": "external"      }    ],    "platform": "instagram"  },  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Campos de la respuesta

#

Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.

CampoSignificado
usernameNombre de usuario (@usuario).
display_nameNombre visible; puede ser distinto de username.
bioBiografía escrita por la cuenta; puede incluir saltos de línea y emoji.
follower_countSeguidores. null significa no publicado, no 0.
following_countCuentas seguidas. null significa no publicado, no 0.
post_countTotal de publicaciones. null significa no publicado, no 0.
is_privateSi la cuenta es privada.
is_verifiedSi la plataforma verificó la cuenta. null significa que no se puede determinar.
is_businessSi la cuenta es una cuenta comercial.
is_professionalSi la cuenta es profesional (comercial o de creador).
categoryNombre de la categoría según la taxonomía propia de la plataforma, sin normalizar entre plataformas.
external_urlEnlace externo del perfil.
avatar_urlEnlace a la imagen de perfil. Algunas plataformas dan enlaces de CDN con tamaño que pueden caducar.
user_idIdentificador único del usuario en la plataforma.
avatar_hd_urlURL del avatar en alta resolución (avatar_url es la imagen pequeña).
external_urlsTodos los enlaces externos de la biografía: url, title (external_url es solo el primero).
has_reelsSi la cuenta ha publicado Reels.
urlEnlace al registro en la plataforma.
reels_countCantidad de Reels que ha publicado la cuenta (entero).
business_emailCorreo electrónico que la cuenta comercial hace público en el botón "Contact" de su perfil. No aparece si no hay.
business_phoneTeléfono que la cuenta comercial hace público en el botón "Contact" de su perfil. No aparece si no hay.
threads_usernameNombre que muestra la insignia de Threads en el perfil; normalmente es el nombre de usuario de la persona en Threads.
fbidOtro identificador numérico que Meta asigna a la cuenta; no es el mismo número que user_id.
is_memorializedLa cuenta es conmemorativa (el estado que Instagram asigna a una cuenta cuando su titular ha fallecido). Solo aparece en cuentas conmemorativas, con el valor true.
is_joined_recentlyEl perfil tiene la marca "Joined recently". Solo aparece cuando existe esa marca, con el valor true.
account_typeTipo de cuenta: personal (individual), business (comercial) o creator (creador).
emailsCorreos de contacto (un registro puede tener varios), tal como los da la plataforma y sin duplicados.
phonesNúmeros de teléfono que la persona escribió públicamente en la biografía, en un arreglo. Solo se incluyen los que empiezan con + o 00, o que van después de una etiqueta como WhatsApp o Teléfono. No aparece si no hay.
pronounsPronombres indicados en el perfil, en un arreglo.
bio_links_detailCada enlace de la sección de biografía, una entrada por enlace: url (la dirección real, sin la capa de redirección con que Instagram envuelve el enlace), title (título del enlace, solo algunos lo tienen), type (tipo de enlace que da Instagram, como external). external_urls contiene el url y el title de esos mismos enlaces.
messaging_idsCuentas de mensajería escritas públicamente en la biografía, una entrada por cuenta con la forma {app, id}; app es un valor como wechat, line, telegram, kakao, skype o signal.
business_addressDirección que la cuenta comercial hace pública, como objeto: street, city, zip, lat, lng; cada uno aparece solo si está disponible.
platformIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).

Errores y facturación

#
401
Falta la clave o no es válida.
402
Saldo insuficiente. Recarga primero.
422
Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
429
Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
503
No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
200 vacío
Sin datos. Sin cargo.

Errores

Preguntas frecuentes

¿Qué campos devuelve la consulta de cuenta por identificador?

Un objeto: username, display_name, bio, follower_count, following_count, post_count, is_private, is_verified, account_type, external_url, user_id y más.

¿De dónde saco user_id?

Del user_id de un resultado de profile o del author_id de un resultado de publicación. Los dos son este identificador.

¿Cuánto cuesta consultar una cuenta por identificador?

Se cobra por llamada: $0.000556 cada una, o $0.56 por cada 1000 llamadas, sea cual sea el número de campos. Las llamadas fallidas y los resultados vacíos no se cobran.

¿Tengo que iniciar sesión en Instagram para consultar una cuenta por identificador?

No. Pon tu clave de API de EveryInfra en la cabecera Authorization: Bearer; no necesitas iniciar sesión en Instagram ni un token de acceso.

¿En qué se diferencian profile_by_id y profile?

Cambia la entrada: profile_by_id usa el user_id numérico y profile usa username. El resultado de profile_by_id no trae recent_posts ni highlight_count.

La misma clave de API de EveryInfra sirve para las demás capacidades de Instagram, por ejemplo profile, que lee un perfil a partir de username.

Google Analytics solo si aceptas. Privacidad