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.
rankda el puesto de cada cuenta en la listapost_like_countes 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
Últimas 24 horas
Últimos 30 días
1Solicitud
POST /api/v1/social { "platform": "instagram", "action": "likers", "params": { "url": "https://www.instagram.com/p/DbYmqpplO_N/" } }2Respuesta JSON
{ "results": [ { "username": string, "name": string, "is_private": boolean, "is_verified": boolean }, … ] }3Filas
username name is_private is_verified string string boolean boolean 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
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.
| Campo | Tipo | Significado |
|---|---|---|
| id | string | Identificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas. |
| username | string | Nombre de usuario (@usuario). |
| url | string | Enlace al registro en la plataforma. |
| name | string | Nombre del propio objeto, en capacidades de cuentas, productos y negocios. |
| avatar_url | string | Enlace a la imagen de perfil. Algunas plataformas dan enlaces de CDN con tamaño que pueden caducar. |
| is_private | boolean | Si la cuenta es privada. |
| is_verified | boolean | Si la plataforma verificó la cuenta. null significa que no se puede determinar. |
| rank | number | Posició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». |
| platform | string | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
| category | string | Nombre de la categoría según la taxonomía propia de la plataforma, sin normalizar entre plataformas. |
| is_business | boolean | Si 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_url | string | URL del avatar en alta resolución (avatar_url es la imagen pequeña). |
| highlight_count | number | Cantidad de destacados (Highlights). |
| has_reels | boolean | Si la cuenta ha publicado Reels. |
| reels_count | number | Cantidad de Reels que ha publicado la cuenta (entero). |
| social_context | string | La 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_urls | array | Todos los enlaces externos de la biografía: url, title (external_url es solo el primero). |
| post_url | string | Enlace 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_hidden | boolean | El 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_verifiedyis_privatepara 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_businesses verdadero para ver qué cuentas de empresa dieron «me gusta».Detecta «me gusta» ocultos
likes_hiddenes 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.
| Aspecto | Instagram Graph API | EveryInfra |
|---|---|---|
| Acceso necesario | Token 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
urles 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_tokencomopage_tokental 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_hiddenes 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.
| Llamadas | Costo |
|---|---|
| 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
#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.
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
#| Nombre | Ubicación | Tipo | Obligatorio | Por defecto | Descripción |
|---|---|---|---|---|---|
Authorization | header | string | Sí | - | 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. |
platform | body | string | Sí | instagram | Identificador de la plataforma, valor fijo. |
action | body | string | Sí | likers | Identificador de la capacidad, valor fijo. |
url | body.params | string | Sí | - | 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_token | body.params | string | No | - | 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
#{ "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.
| Campo | Significado |
|---|---|
id | Identificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas. |
username | Nombre de usuario (@usuario). |
url | Enlace al registro en la plataforma. |
name | Nombre del propio objeto, en capacidades de cuentas, productos y negocios. |
avatar_url | Enlace a la imagen de perfil. Algunas plataformas dan enlaces de CDN con tamaño que pueden caducar. |
is_private | Si la cuenta es privada. |
is_verified | Si la plataforma verificó la cuenta. null significa que no se puede determinar. |
rank | Posició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». |
platform | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
category | Nombre de la categoría según la taxonomía propia de la plataforma, sin normalizar entre plataformas. |
is_business | Si 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_url | URL del avatar en alta resolución (avatar_url es la imagen pequeña). |
highlight_count | Cantidad de destacados (Highlights). |
has_reels | Si la cuenta ha publicado Reels. |
reels_count | Cantidad de Reels que ha publicado la cuenta (entero). |
social_context | La 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_urls | Todos los enlaces externos de la biografía: url, title (external_url es solo el primero). |
post_url | Enlace 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_hidden | El 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.
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.
Capacidades de Instagram relacionadas
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.
- Detalles de la publicación
post$0.56 por cada 1000 llamadasProcesa una o varias URL enurlsy devuelve publicaciones de Instagram con autor, texto, tipo de medio y métricas visibles. - Detalles
profile$0.56 por cada 1000 llamadasResuelve unusernamede Instagram y devuelve nombre, biografía, contadores y señales públicas de cuenta. - Análisis de la cuenta
persona$0.56 por cada 1000 llamadasConsulta medianteusernamelos mismos campos públicos queprofiley añade un objetopersonaescrito por IA con sector, nicho, autenticidad y resumen. - Publicaciones del usuario
user_posts$0.56 por cada 1000 llamadasObtiene publicaciones públicas delusername, con URL, texto, formato y contadores por pieza. - Descubrimiento de contenido
discover$0.56 por cada 1000 llamadasDescubre publicaciones porkeywordy permite elegirresults_type. - Comentarios
comments$0.79 por cada 1000 llamadasLee comentarios de laurlde una publicación, con autor, likes, respuestas y fecha cuando existen. - Reels
reels$1.19 por cada 1000 llamadasConsulta Reels asociados ausernamey devuelve descripción, título, reproducciones, duración y texto cuando está disponible. - Contenido por hashtag
hashtag$0.56 por cada 1000 llamadasBusca contenido delhashtag, aceptando alias compatibles de etiqueta o palabra, y distingue posts de Reels medianteresults_type. - Seguidores
followers$0.56 por cada 1000 llamadasObtiene parausernamecontadores y señales de conexión agregadas. - Lista de seguidores
followers_list$0.56 por cada 1000 llamadasEnumera cuentas seguidoras delusernamecon relación y perfil público cuando están disponibles. - Lista de cuentas seguidas
following_list$0.56 por cada 1000 llamadasLista cuentas seguidas por elusername, conservando privacidad y verificación visibles. - Búsqueda de cuentas
user_search$4.81 por cada 1000 llamadasBusca cuentas de Instagram porkeyword, en el orden en que la búsqueda de Instagram las clasifica para esa palabra (rankdesde 1). - Búsqueda de Reels
reels_search$7.19 por cada 1000 llamadasBusca Reels de Instagram porkeyword, por ejemplo coffee. - Cuentas similares
similar_profiles$8.81 por cada 1000 llamadasLista las cuentas que Instagram sugiere como similares a unusername, por ejemplo nasa, ordenadas por seguidores (rankdesde 1). - Publicaciones etiquetadas
tagged_posts$7.44 por cada 1000 llamadasLista publicaciones públicas de otras cuentas que etiquetan a unusername(también vale la URL del perfil o el ID numérico). - Historias
stories$1.5 por cada 1000 llamadasDevuelve las historias que una cuenta de Instagram tiene activas ahora, a partir de su usuario. - Historias destacadas
highlights$1.6 por cada 1000 llamadasLista las historias destacadas de un perfil de Instagram. - Respuestas a comentarios
comment_replies$0.88 por cada 1000 llamadasLee las respuestas a un comentario de una publicación o Reel de Instagram, con el enlace de la publicación y eliddel comentario que devuelvecomments. - Publicaciones de un lugar
location_posts$0.56 por cada 1000 llamadasLista las publicaciones etiquetadas en un lugar de Instagram, a partir delocation_id(eliddelocation_detailen una publicación, o el enlace de la página del lugar). - Reels con una misma música
audio_posts$0.56 por cada 1000 llamadasLista los Reels de Instagram que usan una misma música, a partir deaudio_id(elaudio_iddemusicen una publicación, o el enlace de la página del audio). - Exploración
explore$0.56 por cada 1000 llamadasLee una página de las publicaciones que Instagram recomienda en Explore; no necesita ningún parámetro. - Estadísticas de interacción
engagement$0.56 por cada 1000 llamadasCalcula la interacción de una cuenta de Instagram a partir de sus últimas publicaciones, conusername. - Perfil por ID numérico
profile_by_id$0.56 por cada 1000 llamadasConsulta una cuenta de Instagram a partir de suuser_idnumérico. - Acerca de esta cuenta
user_about$0.56 por cada 1000 llamadasLee el panel «Información sobre esta cuenta» de un perfil de Instagram a partir deusername: el mes en que se unió (joined_at), elcountry, cuántas veces cambió de nombre de usuario (former_usernames_count) y cuándo se verificó. - Datos de un lugar
location_info$0.56 por cada 1000 llamadasLee un lugar de Instagram a partir de sulocation_id: nombre, categoría, coordenadas (lat,lng), dirección cuando figura ypost_count. - Reconocimiento de enlaces
resolve_links$0.56 por cada 1000 llamadasConvierte la referencia a una publicación que pasas entext(enlace, shortcode o ID numérico) en sus tres formas:shortcode,media_idyurl. - Código para insertar una publicación
oembed$0.56 por cada 1000 llamadasObtén los datos oEmbed y el código para insertar una publicación o Reel de Instagram a partir de suurl: los mismos campos que el oEmbed oficial de Instagram, conhtmllisto para pegar en una página web. - Traducción de una publicación
post_translation$6.39 por cada 1000 llamadasTraduce el texto de una publicación de Instagram altarget_language(por defectoen), con suurlomedia_id. - Lugares cercanos
location_nearby$0.56 por cada 1000 llamadasLista los lugares que Instagram muestra cerca de un lugar, a partir de sulocation_id: unas 20 filas por llamada, sin página siguiente. - Búsqueda de hashtags
hashtag_search$0.56 por cada 1000 llamadasBusca hashtags de Instagram para unakeyword: los que sugiere el cuadro de búsqueda, con elpost_countde cada uno, de unos pocos a unos 15 por llamada, sin página siguiente. - Historias de un destacado
highlight_stories$0.56 por cada 1000 llamadasLee todas las historias de un destacado de Instagram conhighlight_id(eliddehighlightso un enlace del destacado): hasta 100 historias en una llamada, con los enlaces de los medios,posted_atyduration_seconds. - Traducción de comentarios
comment_translations$6.39 por cada 1000 llamadasTraduce hasta 10 comentarios de una publicación de Instagram, con laurlde la publicación ycomment_ids, altarget_language(por defectoen). - Reels recomendados
recommended_reels$1.18 por cada 1000 llamadasLee los Reels que Instagram recomienda en su página de Reels, 10 por página; no necesita parámetros. - Republicaciones de una cuenta
user_reposts$0.56 por cada 1000 llamadasLista las publicaciones y Reels que una cuenta de Instagram republicó en su perfil, conusername, 12 por página. - Ciudades de un país
location_cities$0.56 por cada 1000 llamadasLista las ciudades del directorio de lugares de Instagram para uncountry_code, 96 por página. - Lugares de una ciudad
city_locations$0.56 por cada 1000 llamadasLista los lugares del directorio de lugares de Instagram para una ciudad, concity_id, 96 por página. - Perfiles en lote
profiles_batch$0.56 por cada 1000 llamadasConsulta hasta 20 cuentas de Instagram a la vez conusernames, cada una como nombre de usuario (por ejemplonatgeo) o enlace de perfil.