instagram/
posts

Collectez les publications Instagram publiques d’un ou plusieurs noms d’utilisateur, avec légendes normalisées, informations sur l’auteur, médias, hashtags, mentions, horodatages et engagement visible.

Instagram Posts API

Publications
Métadonnées des médias
Données publiques
0,34 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 Posts

Les publications Instagram sont des contenus du fil, avec légendes, contexte de l’auteur, images ou vidéos, horodatages, hashtags, mentions et engagement visible. Ces signaux de contenu servent à étudier les créateurs, à passer en revue des campagnes, à analyser les médias et à produire des rapports historiques.

Fonctionnalités de la Instagram Posts API

  • Collecte de publications par nom d’utilisateurCollectez les publications Instagram publiques d’un ou plusieurs noms d’utilisateur dans une seule structure de réponse normalisée.
  • Références et dimensions des médiasRenvoie les références publiques des médias et des miniatures, leurs dimensions et la durée des vidéos dans des champs de médias normalisés.
  • Enregistrements de photos et de vidéosNormalise les publications publiques de photos et de vidéos dans une même structure de réponse.
  • Champs de contenu et d’engagementInclut dans chaque enregistrement le texte de la légende, l’identité de l’auteur, la date de publication, les indicateurs visibles, les hashtags et les mentions.
  • Seulement du publicLes publications privées, supprimées, restreintes ou réservées aux comptes connectés n’apparaissent pas dans la réponse.

Paramètres de la Instagram Posts API

ParamètresObligatoireDescription
usernamesObligatoireNoms d’utilisateur Instagram publics, sans @, séparés par des virgules ou des retours à la ligne.
results_limitFacultatifNombre maximal d’enregistrements que la tâche de collecte doit demander. Doit être un entier positif.

Comment utiliser la Instagram Posts API

Soumettez des noms d’utilisateur publics en tâche asynchrone, interrogez l’ID de tâche, puis lisez les publications normalisées grâce à la pagination par curseur.

  1. Préparez un ou plusieurs noms d’utilisateur Instagram publics, sans @.
  2. Envoyez usernames et, au besoin, results_limit en POST à /v1/instagram/posts.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
  4. Lisez /v1/tasks/{task_id}?limit=50 et suivez results.next_cursor tant qu’il reste des enregistrements.
curl -X POST "https://api.socq.ai/v1/instagram/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["natgeo"],"results_limit":25}'

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

Cas d’usage de la Instagram Posts API

  • Collecte des publications d’un profil : Rassemblez les publications publiques de noms d’utilisateur Instagram choisis dans des enregistrements normalisés, avec références de médias et identifiants stables.
  • Recherche de contenus : Collectez légendes, horodatages, hashtags et compteurs d’engagement visibles de publications examinées par des équipes de recherche ou d’analyse.
  • Workflows d’archivage : Stockez métadonnées des publications, références de médias, contexte de l’auteur, URL sources et dates de collecte pour des files de revue, des systèmes de reporting ou des registres internes.
  • Contrôle qualité des campagnes : Passez en revue les publications publiques renvoyées pour des noms d’utilisateur de créateurs ou de marques avant de rapprocher certains enregistrements des données de campagne.
  • Enrichissement du contenu des profils : Rapprochez ID de publication, informations sur l’auteur, légendes, références de médias et indicateurs visibles de vos fiches de profils ou de campagnes existantes.

Conseils d’expert pour la Instagram Posts API

  • Envoyez les noms d’utilisateur sans le préfixe @ et gardez de petits lots pendant la validation d’un nouveau workflow.
  • Attendez-vous à ce que certains enregistrements publics omettent références de médias, compteurs ou horodatages, selon la disponibilité à la source.
  • Appliquez des nouvelles tentatives prudentes avec backoff face aux réponses 429, de vérification (challenge) ou de blocage temporaire, au lieu de réessayer de façon agressive.
  • Utilisez Reels API pour collecter les Reels au niveau d’un profil, Search API pour la découverte et Comments API lorsque les fils de commentaires publics comptent.
  • Évitez de bâtir des workflows autour de comptes privés, de stories, de stories à la une ou de champs réservés aux comptes connectés.

En complément de la Instagram Posts API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Instagram.

  • 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 Tagged Posts API — Collectez les publications publiques qui identifient des profils donnés, avec auteurs, médias, mentions, contexte des comptes identifiés et engagement.
  • 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 Posts API — FAQ

Instagram Posts API collecte les publications accessibles publiquement d’un ou plusieurs noms d’utilisateur Instagram. Elle renvoie des légendes normalisées, des informations sur l’auteur, des références de médias, des hashtags, des mentions, des horodatages et les nombres d’engagement visibles.

L’endpoint actuel accepte un ou plusieurs noms d’utilisateur publics. Il n’accepte comme entrée ni URL de publication individuelle ni shortcode.

Oui. Lorsque les résultats publics exposent des données de médias, les éléments normalisés peuvent comprendre des URL d’images ou de vidéos, des miniatures, des dimensions et la durée des vidéos.

Les champs courants sont l’ID de la publication, le shortcode, l’URL canonique, l’auteur, la légende, la date de publication, les indicateurs visibles, les références de médias, les hashtags, les mentions et la date de collecte.

Non. Les publications privées, supprimées, restreintes ou réservées aux comptes connectés peuvent renvoyer des données limitées ou aucun enregistrement, car l’endpoint ne collecte que des résultats accessibles publiquement.

Elle peut renvoyer des références publiques de médias lorsque les résultats publics les exposent. Les clients doivent tout de même gérer les URL de médias manquantes, expirées ou restreintes, car la disponibilité varie selon le type de publication et la réponse de la source.

Adoptez des débits de requêtes prudents, des lots de noms d’utilisateur plus petits, un backoff après les réponses 429 ou de vérification, et réessayez plus tard lorsqu’une source publique est momentanément indisponible.