API de Cuentas que dieron me gusta de Instagram

Obtén las cuentas que dieron «me gusta» a una publicación o Reel a partir de su url: cada fila trae username, rank, is_verified y is_private, por $1.32 por cada 1000 llamadas.

  • rank da el puesto de cada cuenta en la lista
  • post_like_count es el total de «me gusta» de la publicación
  • Pagina con page_token; cada página es una llamada

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": "likers",
      "params": {
        "url": "https://www.instagram.com/p/DbYmqpplO_N/"
      }
    }
  2. 2Respuesta JSON

    {
      "results": [
        {
          "username": string,
          "name": string,
          "is_private": boolean,
          "is_verified": boolean
        },
        …
      ]
    }
  3. 3Filas

    usernamenameis_privateis_verified
    stringstringbooleanboolean
  4. 4CSV

    instagram-likers-sample.csv id,username,url,name,avatar_url,is_private,is_verified,rank,platform,category,is_business,business_email,business_phone,avatar_hd_url,highlight_count,has_reels,reels_count,social_context,emails,phones,external_urls,post_url,post_like_count,likes_hidden

La solicitud lleva el enlace de la publicación en url y devuelve una página de cuentas con next_page_token. Cada cuenta es una fila con username, rank y más, lista como tabla de campos o CSV.

Qué datos obtienes

Cada fila es una cuenta que dio «me gusta» a la publicación. La tabla enumera los campos que devuelve cada fila, con su tipo y su significado, y no muestra ningún valor.

CampoTipoSignificado
idstringIdentificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas.
usernamestringNombre de usuario (@usuario).
urlstringEnlace al registro en la plataforma.
namestringNombre del propio objeto, en capacidades de cuentas, productos y negocios.
avatar_urlstringEnlace a la imagen de perfil. Algunas plataformas dan enlaces de CDN con tamaño que pueden caducar.
is_privatebooleanSi la cuenta es privada.
is_verifiedbooleanSi la plataforma verificó la cuenta. null significa que no se puede determinar.
ranknumberPosición desde 1: el orden de esta fila dentro de este resultado. user_search: primero las cuentas que devolvió el cuadro de búsqueda de Instagram (matched_by es search_box), en el orden del cuadro de búsqueda; después los autores de publicaciones encontradas con esta palabra clave, que completan la cantidad (matched_by es post_author); los resultados sin matched_by llevan la posición en que Instagram clasifica la cuenta para esta palabra clave. similar_profiles: el lugar de la cuenta entre las similares, ordenadas por seguidores. likers: el lugar de la cuenta en la lista de «me gusta».
platformstringIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).
categorystringNombre de la categoría según la taxonomía propia de la plataforma, sin normalizar entre plataformas.
is_businessbooleanSi la cuenta es una cuenta comercial.
business_email—Correo electrónico que la cuenta comercial hace público en el botón "Contact" de su perfil. No aparece si no hay.
business_phone—Teléfono que la cuenta comercial hace público en el botón "Contact" de su perfil. No aparece si no hay.
avatar_hd_urlstringURL del avatar en alta resolución (avatar_url es la imagen pequeña).
highlight_countnumberCantidad de destacados (Highlights).
has_reelsbooleanSi la cuenta ha publicado Reels.
reels_countnumberCantidad de Reels que ha publicado la cuenta (entero).
social_contextstringLa línea de texto que Instagram muestra debajo de la cuenta, como Followed by un usuario o 632 followers; se devuelve tal cual (casi siempre en inglés). No aparece si no hay.
emails—Correos de contacto (un registro puede tener varios), tal como los da la plataforma y sin duplicados.
phones—Nú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.
external_urlsarrayTodos los enlaces externos de la biografía: url, title (external_url es solo el primero).
post_urlstringEnlace de la publicación.
post_like_count—(likers) Total de «me gusta» de la publicación, igual en todas las filas. likes_hidden es true cuando el autor ocultó el recuento.
likes_hiddenbooleanEl autor ocultó la cantidad de "me gusta". Solo aparece cuando está oculta, con el valor true; en ese caso normalmente no hay like_count.

Casos de uso

  • Mira quién dio «me gusta»

    Lee username, is_verified y is_private para ver si dieron «me gusta» cuentas verificadas o privadas.

  • Compáralo con el total

    Cada fila trae post_like_count, el total de «me gusta» de la publicación. Compáralo con las cuentas recibidas para saber cuánto de la lista tienes.

  • Encuentra cuentas de empresa

    Quédate con las filas donde is_business es verdadero para ver qué cuentas de empresa dieron «me gusta».

  • Detecta «me gusta» ocultos

    likes_hidden es verdadero en la fila cuando el autor oculta el recuento. Una publicación así también puede devolver un resultado vacío.

Instagram Graph API frente a EveryInfra

Comparación entre la Graph API oficial de Instagram y likers de EveryInfra: acceso.

AspectoInstagram Graph APIEveryInfra
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.

La cita procede de la documentación para desarrolladores de Meta (página IG User), comprobada el 2026-11-22. Esta fila compara solo el acceso. Fuentes oficiales: IG User (actualizada el 2026-04-22)

Límites y detalles a tener en cuenta

  • url es obligatorio: el enlace de una publicación o Reel (forma /p/ o /reel/).
  • La lista de «me gusta» que da la web de Instagram tiene tope, así que no se obtienen todas las cuentas. Para el total exacto, usa post_like_count.
  • El tamaño de página varía. Una página corta no significa el final; la última página es la que no trae next_page_token.
  • Para paginar, devuelve next_page_token como page_token tal como lo recibiste, con los demás parámetros iguales a los de la primera página. El token vale 24 horas y cada página cuenta como una llamada.
  • Una publicación cuyo autor oculta el recuento puede devolver un resultado vacío. Si llegan filas, likes_hidden es verdadero en ellas.

Precios

Cada llamada cuesta $0.001319, sea cual sea el número de filas, y cada página que lees cuenta como una llamada. Las llamadas fallidas y los resultados vacíos no se cobran.

LlamadasCosto
10,000$13.19
100,000$131.94
1,000,000$1,319.44

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": "likers",
  "params": {
    "url": "https://www.instagram.com/p/DbYmqpplO_N/"
  }
}'

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 likers, 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: Cuentas que dieron me gusta (instagram/likers).

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 likers, y los parámetros dentro de params.
- Parámetros obligatorios:
  - url: Enlace individual de una publicación o Reel de Instagram para comments y likers; no es el perfil de la cuenta. Aunque en reels hay una rama de compatibilidad para URL, aún debes cumplir con el username obligatorio.
- Parámetros opcionales:
  - page_token: Token de paginación de user_posts, tagged_posts, comments, followers_list, user_search, similar_profiles, comment_replies, likers, location_posts, audio_posts y explore. Omítelo en la primera página.
- Devuelve una lista de registros. Campos principales de cada registro: id, username, url, name, avatar_url, is_private (Si la cuenta es privada), is_verified, rank (Posición desde 1: el orden de esta fila…), category, is_business (Si la cuenta es una cuenta comercial), business_email (Correo electrónico que la cuenta comerc…), business_phone (Teléfono que la cuenta comercial hace p…); 23 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=instagram.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "instagram",
  "action": "likers",
  "params": {
    "url": "https://www.instagram.com/p/DbYmqpplO_N/"
  }
}
- Precio: $1.32 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ílikersIdentificador de la capacidad, valor fijo.
urlbody.paramsstringSí-Enlace individual de una publicación o Reel de Instagram para comments y likers; no es el perfil de la cuenta. Aunque en reels hay una rama de compatibilidad para URL, aún debes cumplir con el username obligatorio. En comments, si la publicación no existe o no se puede ver (eliminada, o de una cuenta privada), la respuesta es 200 con un resultado vacío y empty_reason igual a post_unavailable, sin cobro; reintentar con el mismo enlace no cambia el resultado. Una nueva consulta del mismo enlace dentro de 24 horas devuelve el mismo resultado, también sin cobro.
page_tokenbody.paramsstringNo-Token de paginación de user_posts, tagged_posts, comments, followers_list, user_search, similar_profiles, comment_replies, likers, location_posts, audio_posts y explore. Omítelo en la primera página; devuelve tal cual el next_page_token, con los demás parámetros igual (salvo limit si lo hay). Cada página es una llamada; el token dura 24 horas. Sin next_page_token no hay más páginas: pagination.stop_reason es end_of_list al final, o depth_limit si ahora no se llega más lejos; pueden quedar datos.

Ejemplo de respuesta

#
Todavía no hay una muestra real para estos parámetros de ejemplo: se muestra la estructura de la respuesta y sus campos según la definición de la API, con … como marcadores. No es el resultado de una llamada real.
json
{  "id": "req_…",  "platform": "instagram",  "action": "likers",  "results": [    {      "id": …,      "username": …,      "url": …,      "name": …,      "avatar_url": …,      "is_private": …,      "is_verified": …,      "rank": …,      "platform": …,      "category": …,      "is_business": …,      "business_email": …,      "business_phone": …,      "avatar_hd_url": …,      "highlight_count": …,      "has_reels": …,      "reels_count": …,      "social_context": …,      "emails": …,      "phones": …,      "external_urls": …,      "post_url": …,      "post_like_count": …,      "likes_hidden": …    }  ],  "next_page_token": …,  "pagination": { … },  "count": …,  "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
idIdentificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas.
usernameNombre de usuario (@usuario).
urlEnlace al registro en la plataforma.
nameNombre del propio objeto, en capacidades de cuentas, productos y negocios.
avatar_urlEnlace a la imagen de perfil. Algunas plataformas dan enlaces de CDN con tamaño que pueden caducar.
is_privateSi la cuenta es privada.
is_verifiedSi la plataforma verificó la cuenta. null significa que no se puede determinar.
rankPosición desde 1: el orden de esta fila dentro de este resultado. user_search: primero las cuentas que devolvió el cuadro de búsqueda de Instagram (matched_by es search_box), en el orden del cuadro de búsqueda; después los autores de publicaciones encontradas con esta palabra clave, que completan la cantidad (matched_by es post_author); los resultados sin matched_by llevan la posición en que Instagram clasifica la cuenta para esta palabra clave. similar_profiles: el lugar de la cuenta entre las similares, ordenadas por seguidores. likers: el lugar de la cuenta en la lista de «me gusta».
platformIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).
categoryNombre de la categoría según la taxonomía propia de la plataforma, sin normalizar entre plataformas.
is_businessSi la cuenta es una cuenta comercial.
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.
avatar_hd_urlURL del avatar en alta resolución (avatar_url es la imagen pequeña).
highlight_countCantidad de destacados (Highlights).
has_reelsSi la cuenta ha publicado Reels.
reels_countCantidad de Reels que ha publicado la cuenta (entero).
social_contextLa línea de texto que Instagram muestra debajo de la cuenta, como Followed by un usuario o 632 followers; se devuelve tal cual (casi siempre en inglés). No aparece si no hay.
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.
external_urlsTodos los enlaces externos de la biografía: url, title (external_url es solo el primero).
post_urlEnlace de la publicación.
post_like_count(likers) Total de «me gusta» de la publicación, igual en todas las filas. likes_hidden es true cuando el autor ocultó el recuento.
likes_hiddenEl autor ocultó la cantidad de "me gusta". Solo aparece cuando está oculta, con el valor true; en ese caso normalmente no hay like_count.

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é devuelve la API de «me gusta» de Instagram?

Devuelve las cuentas que dieron «me gusta» a una publicación o Reel, una fila por cuenta: id, username, url, name, avatar_url, is_private, is_verified, rank, post_like_count, likes_hidden y más.

¿Puedo obtener todas las cuentas que dieron «me gusta»?

No siempre. La lista que da la web de Instagram tiene tope y el tamaño de página varía. Si una respuesta no trae next_page_token, no hay página siguiente. Para el total, usa post_like_count.

¿Cuánto cuesta el endpoint de «me gusta»?

Se cobra por llamada: $0.001319 cada una, o $1.32 por cada 1000 llamadas, no por fila. Cada página cuenta como una llamada. Las llamadas fallidas y los resultados vacíos no se cobran.

¿Tengo que iniciar sesión en Instagram para leer los «me gusta»?

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 likers y followers_list?

likers lee las cuentas que dieron «me gusta» a una publicación; su entrada es el url de la publicación. followers_list lee las cuentas que siguen a una cuenta; su entrada es username.

La misma clave de API de EveryInfra sirve para las demás capacidades de Instagram, por ejemplo comments, que lee los comentarios de la misma publicación.

Google Analytics solo si aceptas. Privacidad