Instagram Reels
Les Reels Instagram sont des vidéos courtes accompagnées de légendes, du contexte de leur créateur, de médias, d’audio, d’une durée, de hashtags, de mentions, de nombres de lectures et d’un engagement visible. Ces signaux créatifs et de performance servent à étudier les formats, comparer des créateurs, évaluer des campagnes et analyser les tendances.
Fonctionnalités de la Instagram Reels API
- Collecte des Reels d’un profilRécupérez les Reels publics d’un ou plusieurs noms d’utilisateur Instagram dans une seule structure de réponse normalisée.
- Contenu, médias et engagementRenvoie les légendes, horodatages, lectures, mentions J’aime, commentaires, partages, durées, miniatures, références vidéo, hashtags, mentions et métadonnées audio.
- Plafond de résultats demandéServez-vous de results_limit pour plafonner le nombre de Reels demandés à chaque requête.
- Limite aux données publiquesLes Reels privés, restreints, supprimés ou réservés aux comptes connectés restent hors du périmètre des résultats.
Paramètres de la Instagram Reels 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 Reels API
Envoyez des noms d’utilisateur publics sous forme de tâche asynchrone, interrogez son ID de tâche, puis lisez les Reels normalisés 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/reels.
- 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/reels" \
-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 Reels API
- Étude des performances des Reels : Collectez les lectures, mentions J’aime, commentaires, partages, légendes et horodatages publics pour comparer les performances de vidéos courtes.
- Repérage de créateurs : Parcourez les Reels publics de profils pertinents, puis enrichissez les créateurs retenus avec les API de profils ou de chronologie des publications.
- Suivi de campagne : Suivez les Reels publics liés à un lancement, un hashtag, une tendance musicale, un brief de créateur ou un format de contenu récurrent.
- Archivage de médias : Conservez les métadonnées, miniatures, URL source, durées, détails audio et dates de collecte des Reels publics pour vos outils de revue ou de reporting.
- Analyse de l’audio : Exploitez les champs audio publics, lorsqu’ils sont disponibles, pour regrouper des sujets, appuyer une modération ou analyser la création.
Conseils d’expert pour la Instagram Reels API
- Conservez les ID de Reels, shortcodes, URL et ID de tâche stables afin de pouvoir relancer et auditer vos collectes.
- Choisissez des valeurs de results_limit prudentes et prévoyez un repli progressif pour collecter de longues listes de Reels sur des profils publics.
- Attendez-vous à ce que certains Reels publics n’aient ni compteurs, ni références vidéo, ni détails audio, selon la disponibilité de la source.
- Passez par l’API Search pour découvrir des profils, puis par l’API Reels pour récupérer les Reels publics des noms d’utilisateur retenus.
- Ne bâtissez pas de workflow sur des comptes privés, des Reels restreints ou des champs réservés aux comptes connectés.
API associées
En complément de la Instagram Reels 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 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 Audio Reels API — Collectez les Reels publics utilisant un ID audio numérique connu avec légendes, créateurs, médias, horodatages, engagement visible et contexte de l’audio source.
- Instagram Followers Count API
- Instagram Search API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Highlight Items API
- Instagram Post Info 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