API de Publicaciones del usuario de Instagram

Obtén las publicaciones de una cuenta por username, cada una con text, media_type, like_count y comment_count. La llamada devuelve primero 202 y un job_id. $0.56 por cada 1000 llamadas.

Hasta 200 publicaciones por llamada
Devuelve un job_id y luego el resultado
Sin cargo por fallos ni resultados vacíos

Empieza gratis

Salud de la API

Salud 24 h: 79 %
Tiempo medio 24 h: 41.29 s

Saludable / normal
Disponible
Limitada
Casi sin servicio

Casi sin servicio

Últimas 24 horas

Últimos 30 días

1Solicitud

POST /api/v1/social
{
  "platform": "instagram",
  "action": "user_posts",
  "params": {
    "username": "nasa"
  }
}

2Respuesta JSON

{
  "results": [
    {
      "author_id": "",
      "post_id": "De2t82PPyx9",
      "text": "We are not slowing down. 🚀\n\nOur #Artemis III mission will send four astronauts to low Earth orbit next year to test critical systems needed for future lunar landings and we’re accelerating efforts to ensure the success of Artemis IV, the first Artemis mission on the lunar surface…",
      "media_type": "image"
    },
    …
  ],
  "count": 30
}

3Filas

author_id	post_id	text	media_type
	De2t82PPyx9	We are not slowing down. 🚀 Our #Artemis III mission will send four astronauts to low Earth orbit next year to test critical systems needed for future lunar landings and we’re accelerating efforts to ensure the success of Artemis IV, the first Artemis mission on the lunar surface…	image
	De1wbZ6l2Vy	This disc is 50,000 light-years wide! It's the Sombrero Galaxy — seen here by our orbiting @••• telescope. Its unique appearance could be the result of a long-ago merger with other galaxies. #NASA #Space #Galaxy	image

4CSV
instagram-user_posts-sample.csv post_id,url,text,media_type,like_count,comment_count,view_count,author_username,author_name,posted_at,location,id,image_url,video_url,author_id,width,height,is_comments_disabled,author_follower_count,hashtags,top_comments

La solicitud lleva username y un limit opcional, y responde con 202 y un job_id. Consultas el endpoint de trabajos hasta recibir las filas de publicaciones, que pasan a filas de tabla y a un CSV.

Qué datos obtienes

La tabla muestra filas de una llamada real con nasa, capturada el 24 de octubre de 2026, 18:28 (UTC), que devolvió 30 filas. Las barras grises marcan datos personales eliminados (••• en el CSV). En tus llamadas recibes primero un job_id; cuando termina el trabajo, obtienes estos campos según la tabla de campos.

post_id	url	text	media_type	like_count	comment_count	view_count	author_username	author_name	posted_at	location	id	image_url	video_url	author_id	width	height	is_comments_disabled	author_follower_count	hashtags	top_comments
De2t82PPyx9	https://www.instagram.com/p/De2t82PPyx9/	We are not slowing down. 🚀 Our #Artemis III mission will send four astronauts to low Earth orbit next year to test critical systems needed for future lunar landings and we’re accelerating efforts to ensure the success of Artemis IV, the first Artemis mission on the lunar surface…	image	`46089`	`364`	`null`	nasa	NASA	2026-10-23T23:20:57+00:00	`null`	4014598211346836605_528817151	https://instagram.fuba2-1.fna.fbcdn.net/v/t51.82787-15/859070372_18661402093049152_3071139610491516778_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=1&ig_cache_key=NDAxNDU5ODIxMTM0NjgzNjYwNTE4NjYxNDAyMDg3MDQ5MTUy.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjcyMC5…	https://instagram.fuba2-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQNTkECBw2suz97dudN4wjd5tp7fZgWYJZB6PwTVUGMQU9r4E08_w4KcBLpaInhz4kASzQbv8D4AqHGg8nn8IWBidZ5OR5QfmdqpvN0.mp4?_nc_cat=102&_nc_oc=Adq5bLzGCWm2kVZWdS8bGQwb60nMRQoz0Yl-AbZ3EdrSsTV4Mt8qEBWTMMUiwkNKBeQ&_nc_sid=5e9851&_nc_ht=instagra…		`1080`	`1920`	`null`	`null`	`null`	`null`
De1wbZ6l2Vy	https://www.instagram.com/p/De1wbZ6l2Vy/	This disc is 50,000 light-years wide! It's the Sombrero Galaxy — seen here by our orbiting @••• telescope. Its unique appearance could be the result of a long-ago merger with other galaxies. #NASA #Space #Galaxy	image	`693209`	`2199`	`null`	nasa	NASA	2026-10-23T14:19:41+00:00	`null`	4014327632355616114_528817151	https://instagram.fuba2-1.fna.fbcdn.net/v/t51.82787-15/862320651_18661289491049152_6188246238745863140_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=NDAxNDMyNzU3MzgyODI5NTU0MQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTQ0MC5zZHI…	`null`		`1440`	`1440`	`null`	`null`	`null`	`null`

Descargar CSV de ejemplo Campos de la respuesta ↓

Casos de uso

Ritmo de publicación
Toma las últimas publicaciones de una cuenta y usa posted_at y media_type para ver con qué frecuencia y en qué formato publica.
Comparar interacción
Compara like_count y comment_count entre las publicaciones de una misma cuenta.
Agrupar por tema
Cuenta las etiquetas de cada lista hashtags para ver qué temas usa más una cuenta.
Seguir a la competencia
Descarga con regularidad las publicaciones de un competidor y lee text y location para ver qué hay de nuevo.

Instagram Graph API frente a EveryInfra

Comparamos la Graph API oficial de Instagram y user_posts de EveryInfra en tres puntos: qué cuentas se leen, cuántas publicaciones y el acceso.

Aspecto	Instagram Graph API	EveryInfra
Qué cuentas	Business Discovery: "Since you can make nested requests by specifying an edge via the fields parameter, you can request the targeted professional account’s media edge to get all of its published media objects."	`username` es el nombre de la cuenta sin @, o la URL completa del perfil.
Cuántas publicaciones	"Returns a maximum of 10K of the most recently created media."	`limit` va de 1 a 200 y vale 30 por defecto. No se garantiza el historial completo de la cuenta.
Acceso necesario	"Note that a permission only allows access to data created by the app user who granted the permission."	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, comprobadas el 2026-11-09. Fuentes oficiales: Business Discovery (actualizada el 2026-08-12) · IG User Media (actualizada el 2026-09-28) · Instagram Platform overview (actualizada el 2026-10-29)

Límites y detalles a tener en cuenta

La llamada es asíncrona por defecto: devuelve 202 y un job_id, y consultas GET https://api.everyinfra.com/api/v1/jobs/<job_id> hasta que el trabajo termina y entrega las filas de publicaciones.
limit es un entero de 1 a 200 y vale 30 por defecto; un valor mayor devuelve 422 antes de cobrar nada.
No hay parámetro de paginación. Una llamada devuelve como máximo 200 filas, puede devolver menos que limit y no garantiza el historial completo de la cuenta.
No se incluyen Stories privadas ni datos internos de alcance.
hashtags y top_comments no aparecen cuando no hay nada que mostrar. like_count y view_count en null significan que no se publican; no es 0.

Precios

Pagas $0.000556 por llamada, no por fila, y una llamada lee hasta 200 publicaciones. Vale igual para los trabajos asíncronos. Las llamadas fallidas y los resultados vacíos no se cobran.

Llamadas	Costo
10,000	$5.56
100,000	$55.56
1,000,000	$555.56

El total se calcula con 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": "user_posts",
  "params": {
    "username": "nasa"
  }
}'

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

Aquí tienes los parámetros, campos de respuesta, errores y facturación de user_posts; copia la página o ábrela en Markdown para dársela a 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: Publicaciones del usuario (instagram/user_posts).

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 user_posts, y los parámetros dentro de params.
- Parámetros obligatorios:
  - username: Handle de la cuenta de Instagram, se recomienda sin el @ o la URL completa del perfil. profile/persona/user_posts/reels consultan los datos de la cuenta.
- Parámetros opcionales:
  - limit: Número máximo de filas que devuelve esta llamada, un entero de 1 a 200. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas. (por defecto: 30)
- Devuelve una lista de registros. Campos principales de cada registro: post_id, url, text, media_type, like_count, comment_count, view_count, author_username, author_name, posted_at, location, id; 21 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=instagram.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "instagram",
  "action": "user_posts",
  "params": {
    "username": "nasa"
  }
}
- Precio: $0.56 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Este endpoint es asíncrono por defecto: devuelve 202 y un job_id; luego consulta GET https://api.everyinfra.com/api/v1/jobs/{job_id} hasta que el estado sea succeeded o failed.
- 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í	`user_posts`	Identificador de la capacidad, valor fijo.
`username`	body.params	`string`	Sí	-	Handle de la cuenta de Instagram, se recomienda sin el `@` o la URL completa del perfil. `profile`/`persona`/`user_posts`/`reels` consultan los datos de la cuenta; `followers` solo consulta la cantidad de seguidores, `followers_list`/`following_list` consultan la lista de cuentas de seguidores/seguidos.
`limit`	body.params	`integer (1–200)`	No	`30`	Número máximo de filas que devuelve esta llamada, un entero de 1 a 200. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas. Los valores mayores devuelven 422 antes de cualquier cobro.

Ejemplo de respuesta

json

{  "id": "req_…",  "platform": "instagram",  "action": "user_posts",  "results": [    {      "post_id": "De2t82PPyx9",      "url": "https://www.instagram.com/p/De2t82PPyx9/",      "text": "We are not slowing down. 🚀\n\nOur #Artemis III mission will send four astronauts to low Earth orbit next year to test critical systems needed for future lunar landings and we’re accelerating efforts to ensure the success of Artemis IV, the first Artemis mission on the lunar surface…",      "media_type": "image",      "like_count": 46089,      "comment_count": 364,      "author_username": "nasa",      "author_name": "NASA",      "posted_at": "2026-10-23T23:20:57+00:00",      "id": "4014598211346836605_528817151",      "image_url": "https://instagram.fuba2-1.fna.fbcdn.net/v/t51.82787-15/859070372_18661402093049152_3071139610491516778_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=1&ig_cache_key=NDAxNDU5ODIxMTM0NjgzNjYwNTE4NjYxNDAyMDg3MDQ5MTUy.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjcyMC5…",      "video_url": "https://instagram.fuba2-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQNTkECBw2suz97dudN4wjd5tp7fZgWYJZB6PwTVUGMQU9r4E08_w4KcBLpaInhz4kASzQbv8D4AqHGg8nn8IWBidZ5OR5QfmdqpvN0.mp4?_nc_cat=102&_nc_oc=Adq5bLzGCWm2kVZWdS8bGQwb60nMRQoz0Yl-AbZ3EdrSsTV4Mt8qEBWTMMUiwkNKBeQ&_nc_sid=5e9851&_nc_ht=instagra…",      "author_id": "•••",      "width": 1080,      "height": 1920    },    {      "post_id": "De1wbZ6l2Vy",      "url": "https://www.instagram.com/p/De1wbZ6l2Vy/",      "text": "This disc is 50,000 light-years wide!\n\nIt's the Sombrero Galaxy — seen here by our orbiting @••• telescope. Its unique appearance could be the result of a long-ago merger with other galaxies.\n\n#NASA #Space #Galaxy",      "media_type": "image",      "like_count": 693209,      "comment_count": 2199,      "author_username": "nasa",      "author_name": "NASA",      "posted_at": "2026-10-23T14:19:41+00:00",      "id": "4014327632355616114_528817151",      "image_url": "https://instagram.fuba2-1.fna.fbcdn.net/v/t51.82787-15/862320651_18661289491049152_6188246238745863140_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=NDAxNDMyNzU3MzgyODI5NTU0MQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTQ0MC5zZHI…",      "author_id": "•••",      "width": 1440,      "height": 1440    }  ],  "count": 30,  "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
`post_id`	Conserva el significado de la plataforma
`url`	Enlace al registro en la plataforma.
`text`	Texto del contenido sin HTML, completo y sin recortes (en algunas plataformas los resultados de listado solo traen un extracto; lo indican las notas de campos de la plataforma).
`media_type`	Conserva el significado de la plataforma
`like_count`	Me gusta. null significa que la plataforma o esta capacidad no lo publica; no es 0.
`comment_count`	Comentarios. null significa no publicado, no 0.
`view_count`	Visualizaciones o reproducciones. null significa no publicado, no 0.
`author_username`	Nombre de usuario del autor (@usuario), normalmente utilizable en URL.
`author_name`	Nombre visible del autor.
`posted_at`	Fecha de publicación en ISO 8601, UTC (por ejemplo 2026-08-07T12:34:56+00:00). Las cadenas no estándar de la plataforma se transmiten tal cual, así que conviene analizarlas con tolerancia. null significa que la plataforma no la publica.
`location`	Descripción de la ubicación tal como la da la plataforma; el formato varía.
`id`	Identificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas.
`image_url`	Enlace de imagen. Las capacidades con varias imágenes pueden devolver una lista image_urls.
`video_url`	Conserva el significado de la plataforma
`author_id`	Identificador único del autor en la plataforma.
`width`	Conserva el significado de la plataforma
`height`	Conserva el significado de la plataforma
`is_comments_disabled`	Conserva el significado de la plataforma
`author_follower_count`	Seguidores del autor. null significa no publicado.
`hashtags`	Hashtags del texto, en orden de aparición; no aparece si no hay ninguno.
`top_comments`	Conserva el significado de la plataforma

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 Instagram para las publicaciones de un usuario?

Devuelve las publicaciones de la cuenta: post_id, url, text, media_type, like_count y comment_count, y hashtags si los hay. La llamada devuelve 202 y un job_id; consultas el endpoint de trabajos para obtener las filas.

¿Cuántas publicaciones devuelve una llamada y cómo se pagina?

limit va de 1 a 200 y vale 30 por defecto. Una llamada devuelve como máximo 200 filas, puede que menos, y no se garantiza el historial completo. No hay parámetro de paginación.

¿Cuánto cuesta?

Cuesta $0.000556 por llamada, o $0.56 por cada 1000 llamadas, por llamada y no por fila. Los trabajos asíncronos se cobran igual. Las llamadas fallidas y los resultados vacíos no se cobran.

¿Necesito iniciar sesión en Instagram?

No. Envías 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.

¿Qué diferencia hay entre `user_posts` y `reels`?

user_posts devuelve las publicaciones de una cuenta como trabajo asíncrono. reels devuelve solo los Reels de la cuenta, con play_count y duration_sec, en la misma respuesta.

Con la misma clave puedes llamar a otras capacidades de Instagram, como los Reels de la cuenta o las publicaciones que la etiquetan.