instagram/
stories

Collectez les stories qu’un compte Instagram public affiche en ce moment à partir de son nom d’utilisateur, avec l’image ou la vidéo de chaque story, ses heures de publication et d’expiration et ses stickers de lien.

Instagram Stories API

Saisie du nom d’utilisateur
Stories en cours
Stickers de lien
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 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ètresObligatoireDescription
usernameObligatoireNom 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.

  1. Choisissez le compte public à consulter, par exemple natgeo.
  2. Envoyez {"username": "natgeo"} en POST à /v1/instagram/stories et conservez le task_id de la réponse.
  3. Appelez GET /v1/tasks/{task_id} toutes les quelques secondes jusqu’à ce que status vaille succeeded.
  4. 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.

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.

Explorer d’autres plateformes

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

Instagram Stories API — FAQ

Instagram Stories API est une interface programmatique qui collecte les stories actuellement en ligne d’un compte Instagram public, à partir de son nom d’utilisateur. Elle renvoie pour chaque story l’ID et le lien, l’image ou la vidéo, l’image de couverture, l’auteur et l’heure de publication.

Oui. Envoyez le nom d’utilisateur d’un compte public et ses stories reviennent sous forme de données, sans connexion à Instagram de votre côté.

Lorsqu’une story porte un sticker de lien, l’URL de destination du sticker est renvoyée dans extra.link_urls pour cette story.

Les stories restent en ligne 24 heures, donc une ou deux collectes par jour suffisent à capturer chacune d’elles pendant qu’elle est visible.

La tâche se termine par un message indiquant que le profil est introuvable, et les crédits réservés pour elle sont restitués à votre solde.

Vous payez 0,5 crédit par story renvoyée, et une requête qui ne trouve aucune story en ligne ne coûte rien.