Instagram Tagged Posts
Les publications identifiées sur Instagram sont des contenus publics qui désignent un autre profil par une identification au niveau de la publication et peuvent comporter des noms d’utilisateur mentionnés, avec légendes, auteurs, médias, hashtags, horodatages et engagement visible. Ces signaux de contenu et de relation servent à surveiller les identifications, vérifier les attributions, étudier les créateurs et constituer des archives de contenu structurées.
Fonctionnalités de la Instagram Tagged Posts API
- Découverte par identification de profilPrenez des noms d’utilisateur Instagram publics comme cibles et récupérez les publications qui identifient ces profils, et non celles publiées par le compte ciblé.
- Identité de la publication et de l’auteurRecevez les ID, shortcodes, URL et légendes des publications, ainsi que des champs de profil d’auteur normalisés, pour des enregistrements de contenu traçables.
- Contexte des comptes identifiés et des mentionsGardez le contexte structuré de tagged_users à côté des hashtags et des mentions renvoyées, afin de distinguer les différentes relations entre publications.
- Médias et engagement visibleObtenez des références d’image ou de vidéo normalisées, avec les nombres visibles de mentions J’aime, de commentaires, de vues et de lectures fournis pour chaque publication publique.
- Contexte de publicationInclut l’heure de publication et l’heure de collecte normalisées ainsi que le contexte de product_type, pour un examen chronologique et un classement par format de publication.
Paramètres de la Instagram Tagged Posts API
| Paramètres | Obligatoire | Description |
|---|---|---|
usernames | Obligatoire | Un ou plusieurs noms d’utilisateur de profils Instagram publics, sans @, séparés par des virgules ou des retours à la ligne. |
results_limit | Facultatif | Nombre maximal d’enregistrements de publications identifiées demandés par la tâche ; un entier de 1 à 2 000, 100 par défaut. |
Comment utiliser la Instagram Tagged Posts API
Envoyez les noms d’utilisateur des profils cibles sous forme de tâche asynchrone, interrogez l’ID de tâche renvoyé, puis lisez les publications identifiées normalisées grâce à la pagination par curseur.
- Préparez un ou plusieurs noms d’utilisateur Instagram publics, sans le caractère @ initial.
- Envoyez usernames et, au besoin, results_limit de 1 à 2 000 en POST à /v1/instagram/tagged-posts.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
- Lisez /v1/tasks/{task_id}?limit=50 et transmettez results.next_cursor tant que results.has_more vaut true.
curl -X POST "https://api.socq.ai/v1/instagram/tagged-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["instagram"],"results_limit":20}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50 and follow data.results.next_cursorCas d’usage de la Instagram Tagged Posts API
- Surveillance des identifications d’un profil : Exploitez tagged_users, les URL, les légendes, les auteurs et les horodatages pour passer en revue les publications publiques qui identifient des profils choisis.
- Examen des associations à une campagne : Comparez légendes, médias, contexte des comptes identifiés et engagement visible entre les publications liées à l’identification du profil d’une campagne.
- Recherche sur la contribution des créateurs : Appuyez-vous sur l’identité normalisée des auteurs et sur les relations d’identification pour repérer les créateurs publics qui publient autour de comptes sélectionnés.
- Archivage du contenu identifié : Stockez ID, shortcodes, URL renvoyées, références de médias, dates de publication et dates de collecte dans des enregistrements de contenu consultables.
Conseils d’expert pour la Instagram Tagged Posts API
- Retirez le @ initial de chaque nom d’utilisateur cible avant l’envoi afin que la requête utilise un identifiant de profil propre.
- Lisez extra.tagged_users pour les identifications de profils au niveau de la publication et mentions pour les chaînes de mentions renvoyées, sans traiter ces deux champs comme interchangeables.
- Dédoublonnez les collectes répétées avec un ID de publication ou un shortcode, puis gardez l’URL renvoyée de la publication pour la revue et la traçabilité.
- Prévoyez que médias, compteurs d’engagement, indicateurs d’auteur et horodatages puissent être absents, car les enregistrements publics normalisés conservent les champs source nullables.
- Poursuivez avec results.next_cursor tant que results.has_more vaut true, pour que les jeux de résultats plus volumineux ne soient pas tronqués après la première page.
API associées
En complément de la Instagram Tagged Posts API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Instagram.
- Instagram Posts API — Collectez les publications publiques, médias, hashtags, mentions, horodatages et l’engagement par nom d’utilisateur.
- Instagram Reels API — Collectez par nom d’utilisateur les Reels publics, médias, audio, hashtags, mentions et l’engagement.
- Instagram Comments API — Collectez les commentaires publics, auteurs, horodatages, mentions J’aime et réponses à partir d’URL de publications.
- Instagram Profiles API — Récupérez par nom d’utilisateur l’identité publique d’un profil, ses biographies, liens, indicateurs de compte, catégories et nombres visibles.
- Instagram Transcript API — Extrayez le texte de transcription, la langue, le format, les URL sources et les shortcodes à partir d’URL de publications ou de Reels publics.
- Instagram Post Info API — Consultez des URL connues de publications, de Reels ou d’anciens IGTV publics avec légendes, identité de l’auteur, médias, horodatages, engagement visible et contexte de la saisie.
- Instagram Followers Count API
- Instagram Search API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API