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ètres | Obligatoire | Description |
|---|---|---|
usernames | Obligatoire | Noms d’utilisateur Instagram publics, sans @, séparés par des virgules ou des retours à la ligne. |
results_limit | Facultatif | Nombre 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.
- Préparez un ou plusieurs noms d’utilisateur Instagram publics, sans @.
- Envoyez usernames et, au besoin, results_limit en POST à /v1/instagram/posts.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
- 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.
API associées
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.
- 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