Saltar al contenido principal
Lee datos públicos de Instagram como JSON mediante la API de tareas asíncronas. Envía taskType SOCIAL con platform instagram y elige qué leer con action. Cada solicitud completada cuesta 0.5 créditos.

Solicitud

Envía la tarea y luego consulta GET /v1/async/task/{id} o recibe su webhook. Consulta Tareas asíncronas.

Acciones

username acepta un nombre de usuario o la URL de un perfil. postUrl acepta la URL de una publicación, un reel o un IGTV, como https://www.instagram.com/p/Df147tCiAyB/.

Parámetros

  • query: Obligatorio para search. Una palabra clave, la palabra de un hashtag o el nombre de una marca.
  • limit: Opcional. search acepta de 1 a 30, con 10 por defecto. posts acepta de 1 a 12, con 12 por defecto. comments acepta de 1 a 500, con 50 por defecto.

Ejemplo de respuesta

Campos del resultado

  • Cada respuesta repite platform y action. Las listas incluyen returnedCount.
  • profile devuelve id, username, displayName, biography, bioLinks, avatarUrl, profileUrl, isVerified, isPrivate, followerCount, followingCount, postCount, hasReels, highlights, threadsUsername, pronouns y recentPosts. latestStoryAt aparece mientras la cuenta tiene una historia publicada, e isMemorialized marca una cuenta conmemorativa.
  • posts devuelve posts, las 12 publicaciones más recientes de la cuenta, con likeCount, commentCount y publishedAt leídos de la página de cada publicación.
  • post devuelve post y los primeros comments de la publicación. Una publicación tiene id, code, url, mediaType (image, video o carousel), caption, imageUrl, images, videoUrl, width, height, likeCount, commentCount, publishedAt, username, authorFullName, authorIsVerified, authorProfileImageUrl, coauthors, taggedUsers, topics, audio (la canción o el audio original del autor), hasAudio, captionIsEdited, aiLabel y commentsDisabled.
  • comments devuelve comments, cada uno con id, text, username, likeCount, replyCount y publishedAt. Un comentario con GIF incluye gifUrl. availableCount es el número de comentarios de la publicación, y partial: true marca una lista más corta que ese número.
  • search devuelve posts con position, el username del autor, authorId, authorIsVerified y authorProfileImageUrl, y playCount en los reels. source es instagram cuando Instagram tiene una página de búsqueda para la palabra clave, que añade su title, relatedKeywords y el summary propio de Instagram sobre la palabra clave, con las sources a las que apuntan los números de sus notas. Para otras palabras clave, source es web y posts contiene publicaciones y reels públicos de los últimos 30 días.
  • Instagram muestra a un visitante sin sesión iniciada las 12 publicaciones más recientes de un perfil y alrededor de una docena de comentarios de una publicación, y posts, post y comments devuelven eso. Lee post para obtener los recuentos y la hora de publicación de un resultado de búsqueda.
  • Una cuenta o publicación que no existe, una publicación privada o una página que Instagram solo muestra a visitantes con sesión iniciada terminan la tarea con PAGE_UNAVAILABLE. Solo se cobran las solicitudes completadas.

Relacionado