Passer au contenu principal
Lisez les données publiques d’Instagram en JSON via l’API de tâches asynchrones. Envoyez taskType SOCIAL avec platform instagram, et choisissez ce que vous lisez avec action. Une requête terminée coûte 0.5 crédit.

Requête

Soumettez la tâche, puis interrogez GET /v1/async/task/{id} ou recevez son webhook. Voir Tâches asynchrones.

Actions

username accepte un nom d’utilisateur ou l’URL d’un profil. postUrl accepte l’URL d’une publication, d’un reel ou d’une vidéo IGTV, comme https://www.instagram.com/p/Df147tCiAyB/.

Paramètres

  • query : obligatoire pour search. Un mot-clé, le mot d’un hashtag ou un nom de marque.
  • limit : facultatif. search accepte de 1 à 30, avec 10 par défaut. posts accepte de 1 à 12, avec 12 par défaut. comments accepte de 1 à 500, avec 50 par défaut.

Exemple de réponse

Champs du résultat

  • Chaque réponse reprend platform et action. Les listes portent returnedCount.
  • profile renvoie id, username, displayName, biography, bioLinks, avatarUrl, profileUrl, isVerified, isPrivate, followerCount, followingCount, postCount, hasReels, highlights, threadsUsername, pronouns et recentPosts. latestStoryAt apparaît tant que le compte a une story en ligne, et isMemorialized signale un compte commémoratif.
  • posts renvoie posts, les 12 publications les plus récentes du compte, avec likeCount, commentCount et publishedAt lus sur la page de chaque publication.
  • post renvoie post et les premiers comments de la publication. Une publication a id, code, url, mediaType (image, video ou carousel), caption, imageUrl, images, videoUrl, width, height, likeCount, commentCount, publishedAt, username, authorFullName, authorIsVerified, authorProfileImageUrl, coauthors, taggedUsers, topics, audio (le morceau ou le son original de l’auteur), hasAudio, captionIsEdited, aiLabel et commentsDisabled.
  • comments renvoie comments, chacun avec id, text, username, likeCount, replyCount et publishedAt. Un commentaire GIF porte gifUrl. availableCount est le nombre de commentaires de la publication, et partial: true signale une liste plus courte que ce nombre.
  • search renvoie posts avec position, le username de l’auteur, authorId, authorIsVerified et authorProfileImageUrl, ainsi que playCount pour les reels. source vaut instagram quand Instagram a une page de recherche pour le mot-clé, ce qui ajoute son title, ses relatedKeywords et le summary qu’Instagram rédige sur le mot-clé, avec les sources vers lesquelles pointent ses numéros de notes. Pour les autres mots-clés, source vaut web, et posts contient des publications et reels publics des 30 derniers jours.
  • Instagram montre à un visiteur non connecté les 12 publications les plus récentes d’un profil et une douzaine de commentaires d’une publication, et posts, post et comments renvoient ceux-ci. Lisez post pour obtenir les compteurs et l’heure de publication d’un résultat de recherche.
  • Un compte ou une publication qui n’existe pas, une publication privée ou une page qu’Instagram ne montre qu’aux visiteurs connectés termine la tâche avec PAGE_UNAVAILABLE. Seules les requêtes terminées sont facturées.

Voir aussi