Instagram Stories
Les stories Instagram sont des photos et des vidéos qu’un compte partage pendant 24 heures, avec souvent un sticker de lien, un compte identifié ou une offre limitée dans le temps qui n’apparaît jamais dans le fil principal. Les enregistrer pendant qu’elles sont en ligne donne aux équipes marque, marketing et recherche une trace des lancements, des promotions et de l’activité des créateurs qui disparaîtraient sinon.
Fonctionnalités de la Instagram Stories API
- Tout ce que le compte a en ligneUn seul nom d’utilisateur renvoie toutes les stories que le compte affiche au moment où vous envoyez la requête.
- Des médias prêts à archiverChaque story arrive avec l’URL de son image ou de sa vidéo, sa largeur, sa hauteur et une image de couverture, pour stocker ou examiner le contenu plus tard.
- Heure de mise en ligne et heure de disparitionL’heure de publication arrive dans published_at et l’heure d’expiration dans extra.expires_at, ce qui indique exactement de combien de temps vous disposez avant la collecte suivante.
- Liens et mentions restent attachés à la storyLes destinations des stickers de lien figurent dans extra.link_urls et les comptes identifiés dans extra.mentions, rattachés à la story qui les portait.
Paramètres de la Instagram Stories API
| Paramètres | Obligatoire | Description |
|---|---|---|
username | Obligatoire | Nom d’utilisateur du compte Instagram public dont vous voulez les stories actuelles. Le @ initial est facultatif. |
Comment utiliser la Instagram Stories API
Envoyez un nom d’utilisateur, attendez la fin de la tâche et lisez les stories dans son résultat.
- Choisissez le compte public à consulter, par exemple natgeo.
- Envoyez {"username": "natgeo"} en POST à /v1/instagram/stories et conservez le task_id de la réponse.
- Appelez GET /v1/tasks/{task_id} toutes les quelques secondes jusqu’à ce que status vaille succeeded.
- Lisez les stories dans results.items ; quand results.has_more vaut true, transmettez results.next_cursor pour obtenir la page suivante.
curl -X POST "https://api.socq.ai/v1/instagram/stories" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"natgeo"}'
# The response contains a task_id.
# GET /v1/tasks/{task_id} returns the stories once status is succeeded.Cas d’usage de la Instagram Stories API
- Archive quotidienne des stories : Collectez les stories d’une marque une ou deux fois par jour et conservez médias et heures de publication, pour que chaque story reste consultable après son expiration.
- Suivi des promotions : Suivez les URL des stickers de lien que les concurrents ajoutent à leurs stories pour voir quels produits, soldes et pages d’atterrissage ils mettent en avant cette semaine.
- Contrôle des campagnes de créateurs : Rapprochez l’heure, le média et le sticker de lien de la story d’un créateur du brief afin de confirmer que la story convenue a bien été publiée.
Conseils d’expert pour la Instagram Stories API
- Planifiez les exécutions à moins de 24 heures d’intervalle pour que chaque story soit capturée au moins une fois pendant qu’elle est en ligne.
- Téléchargez rapidement après la collecte les images et vidéos que vous voulez garder, car les liens des médias de stories sont des adresses CDN temporaires.
- Lorsque vous collectez de nouveau le même compte, servez-vous de l’id de la story pour ignorer celles que vous avez déjà stockées.
- Pour les stories qu’un compte conserve sur son profil, passez par Instagram Story Highlights et Instagram Highlight Items.
API associées
En complément de la Instagram Stories 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 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 Story Highlights API — Listez les stories à la une publiques d’un nom d’utilisateur avec titres, contexte du propriétaire, nombre de médias et ID de story à la une réutilisables.
- Instagram Similar Accounts API — Listez les comptes qu’Instagram suggère comme similaires à un nom d’utilisateur, avec noms d’utilisateur, noms, avatars et statut de vérification.
- Instagram Followers Count API
- Instagram Search API
- Instagram Comments API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Post Info API
- Instagram Reels Search API
- Instagram Trending Reels 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