Obtener las publicaciones de una cuenta de Instagram con la API
GET /<IG_ID>/media devuelve las publicaciones de una cuenta profesional de Instagram como objetos IG Media, hasta sus 10,000 más recientes. Pide campos como id, media_type, media_url, permalink, thumbnail_url y timestamp, y lee los elementos de un carrusel mediante children. Las respuestas traen cursores before y after para paginar, y since y until las limitan por fecha. Con Instagram Login la llamada va a graph.instagram.com.
easyCoexistence lista las publicaciones de una cuenta de Instagram conectada con list_social_posts, de 1 a 100 por vez, desde Claude, ChatGPT o tu propio código, a través de la API oficial de Meta con el token añadido.
Las publicaciones más recientes que devuelve, como máximo, el edge de media, según la referencia de Meta sobre IG User Media.
Los parámetros de paginación por tiempo del edge de media, que aceptan marcas de tiempo Unix o valores de strtotime.
Dónde se leen las historias: el edge de media no devuelve contenido de historias.
El tipo de contenido que devuelve thumbnail_url, la URL de la imagen en miniatura del contenido.
Cómo indica Meta tratar media_url, que omite en algunos videos; usa permalink o thumbnail_url como alternativa.
¿Cómo se obtienen las publicaciones de una cuenta?
Con un GET al edge de media de la cuenta, indicando los campos a devolver; sin fields, el ejemplo de Meta solo devuelve el id de cada publicación. Con Instagram Login la petición va a graph.instagram.com con un token de acceso de Instagram User que tenga instagram_business_basic, y la respuesta enumera las publicaciones en data, con un objeto paging para la siguiente página.
GET https://graph.instagram.com/<IG_ID>/media
?fields=id,media_type,media_url,permalink,thumbnail_url,timestamp
&limit=25
&access_token=<ACCESS_TOKEN>
{
"data": [
{
"id": "<IG_MEDIA_ID>",
"media_type": "IMAGE",
"media_url": "<CDN_URL>",
"permalink": "https://www.instagram.com/p/<SHORTCODE>/",
"timestamp": "2026-10-30T14:02:11+0000"
}
],
"paging": {
"cursors": { "before": "<CURSOR>", "after": "<CURSOR>" },
"next": "<NEXT_PAGE_URL>"
}
}¿Qué campos puede devolver cada publicación?
Los del objeto IG Media, listados en la referencia de Meta; pide solo los que usas. Dos filas de esa referencia, caption y media_product_type, terminan con la nota Available for Instagram API with Facebook Login only, así que verifícalas con tu configuración antes de depender de ellas:
¿Cómo funciona la paginación?
Con cursores. El objeto paging trae los cursores before y after y, mientras queden resultados, una URL next; la guía de la Graph API de Meta indica detenerse cuando next deja de aparecer, porque una página puede tener menos elementos de los que pide limit. El edge de media también pagina por tiempo: since y until aceptan marcas de tiempo Unix o valores de strtotime y limitan los resultados a ese rango.
¿Cómo se leen las fotos y videos de un carrusel?
Mediante el edge children. Una publicación cuyo media_type es CAROUSEL_ALBUM enumera sus elementos con GET /<IG_MEDIA_ID>/children, usando el mismo token y permiso que el edge de media, y cada elemento es un objeto IG Media con su propio id, media_type y media_url. Meta señala que algunos campos, entre ellos permalink, no se pueden usar en las fotos dentro de un álbum.
GET https://graph.instagram.com/<IG_MEDIA_ID>/children
?fields=id,media_type,media_url
&access_token=<ACCESS_TOKEN>¿Por qué falta media_url en algunas publicaciones?
Meta la omite en contenido de video con audio protegido por derechos de autor o con licencia, incluidas las pistas de la biblioteca de audio de Instagram, y en contenido marcado por infracción de derechos de autor, también en las publicaciones propias de la cuenta. Su referencia indica tratar media_url como opcional y usar permalink o thumbnail_url como alternativa. Un video en vivo solo se puede leer mientras se está transmitiendo.
¿Cómo se muestran las publicaciones en un sitio web?
Desde tu servidor, con el token de larga duración de la cuenta, que dura 60 días y hay que renovar antes de que venza. Enlaza cada elemento a su permalink y actualiza la lista según un calendario: Meta sirve el contenido mediante URL de CDN que respetan la privacidad y que dejan de devolver el archivo una vez eliminado o caducado el contenido. Para mostrar una publicación como la dibuja Instagram, pasa su permalink al endpoint de oEmbed.
¿Cómo se listan las publicaciones con easyCoexistence?
Con list_social_posts, que recibe account_id y un limit de 1 a 100, 25 por defecto, y devuelve las publicaciones recientes de la cuenta con sus IDs, tipos de contenido, URL de medios, miniaturas, permalinks, marcas de tiempo y recuentos de me gusta y comentarios. Lee las publicaciones más recientes, hasta 100, y no tiene cursor para más páginas ni para otros campos.
Errores comunes
- Buscar historias en el edge de media. Meta las deja fuera; GET /<IG_ID>/stories las devuelve durante las 24 horas que duran.
- Crear un feed solo con media_url. Meta la omite en algunos videos, así que conserva permalink o thumbnail_url como alternativa.
- Pedir permalink en los elementos de un carrusel. Meta no lo devuelve para las fotos dentro de un álbum, así que enlaza a la publicación principal.
- Tomar una página corta como la última. Una página puede tener menos elementos que limit; detente solo cuando paging no tenga next.
De US$ 9 a US$ 0.75 por conexión al mes, con descuento a medida que añades conexiones, y los primeros 3 días gratis.
Preguntas frecuentes
¿Cuántas publicaciones puede devolver la API de Instagram?
Hasta las 10,000 más recientes, una página a la vez desde el edge de media. Las historias se obtienen del edge de historias aparte, mientras duran.
¿El edge de media incluye Reels?
Sí. Un Reel es un objeto IG Media como una foto, reportado con media_type VIDEO; las historias son lo que el edge de media deja fuera.
¿Puedo obtener las publicaciones de otra cuenta?
No desde el edge de media, que lee la cuenta detrás del token. Business Discovery devuelve las publicaciones de otra cuenta de empresa o creador, con Facebook Login o Unified Login.
¿Por qué dejó de funcionar una media_url antigua?
Las URL de CDN de Meta respetan la privacidad: dejan de devolver el contenido una vez eliminado o caducado, así que pide URL actuales cuando las necesites.
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