instagram/
tagged-posts

Collectez les publications Instagram publiques qui identifient des profils ciblés, à partir d’un ou plusieurs noms d’utilisateur, avec légendes, auteurs, médias, mentions et engagement visible.

Instagram Tagged Posts API

Identifications de profils
Contexte des publications
Contenu public
0,5 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
usernamesObligatoireUn ou plusieurs noms d’utilisateur de profils Instagram publics, sans @, séparés par des virgules ou des retours à la ligne.
results_limitFacultatifNombre 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.

  1. Préparez un ou plusieurs noms d’utilisateur Instagram publics, sans le caractère @ initial.
  2. Envoyez usernames et, au besoin, results_limit de 1 à 2 000 en POST à /v1/instagram/tagged-posts.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
  4. 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_cursor

Cas 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.

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.

Explorer d’autres plateformes

Combinez les données Instagram avec les données publiques d’autres plateformes sociales prises en charge.

Instagram Tagged Posts API — FAQ

Instagram Tagged Posts API est une interface programmatique qui récupère les publications publiques identifiant les profils désignés par un ou plusieurs noms d’utilisateur envoyés. Elle renvoie l’identité normalisée de la publication et de l’auteur, les légendes, les médias, le contexte des comptes identifiés, les mentions, les horodatages et l’engagement visible.

Non. Cet endpoint découvre les publications qui identifient le profil cible ; les mentions sont des champs renvoyés avec les publications correspondantes lorsque le résultat public les fournit, et non une recherche distincte des publications mentionnant un compte.

Envoyez un tableau usernames non vide de noms d’utilisateur de profils publics ; le mappage d’entrée retire un @ initial. results_limit est facultatif et accepte un entier de 1 à 2 000, avec 100 par défaut.

extra.tagged_users conserve le contexte structuré des identifications de profils renvoyé pour la publication. mentions est une liste distincte de noms d’utilisateur renvoyés comme mentions dans l’enregistrement de contenu normalisé.

Tagged Posts trouve les publications publiques qui identifient des profils choisis. Instagram Posts collecte à l’inverse les publications dont les noms d’utilisateur envoyés sont les auteurs.

Les enregistrements peuvent contenir l’ID, le shortcode, l’URL, la légende, l’identité de l’auteur, les médias, les hashtags, les mentions, les comptes identifiés, le type de produit, les dates de publication et de collecte, ainsi que les nombres visibles de mentions J’aime, de commentaires, de vues ou de lectures.

Seules les publications correspondantes accessibles publiquement peuvent être renvoyées. Des enregistrements ou champs supprimés, restreints, privés, réservés aux comptes connectés ou omis par la source peuvent produire des résultats partiels ou vides.

Lisez jusqu’à 500 résultats de tâche par page et continuez avec next_cursor tant que has_more vaut true.

Les résultats normalisés réussis coûtent 0,5 crédit par enregistrement, sans frais de base. Un résultat vide coûte zéro crédit selon la politique de facturation sans frais de base.