instagram/
stories

Die Stories, die ein öffentliches Instagram-Konto gerade zeigt, per Benutzername erfassen – mit Bild oder Video jeder Story, Zeitpunkten für Veröffentlichung und Ablauf sowie Link-Stickern.

Instagram Stories API

Benutzername als Eingabe
Aktuelle Stories
Link-Sticker
0,5 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

Instagram Stories

Instagram Stories sind Fotos und Videos, die ein Konto 24 Stunden lang teilt und die oft einen Link-Sticker, ein markiertes Konto oder ein zeitlich begrenztes Angebot enthalten, das nie im Haupt-Feed erscheint. Wer sie speichert, solange sie live sind, gibt Marken-, Marketing- und Recherche-Teams ein Protokoll von Produktstarts, Aktionen und Creator-Aktivitäten, das sonst verschwinden würde.

Funktionen der Instagram Stories API

  • Alles, was das Konto gerade zeigtEin Benutzername liefert alle Stories, die das Konto im Moment Ihrer Anfrage online hat.
  • Medien bereit zur ArchivierungJede Story kommt mit der URL ihres Bildes oder Videos, Breite und Höhe sowie einem Titelbild, damit sich der Inhalt später speichern oder prüfen lässt.
  • Wann sie online ging und wann sie abläuftDen Veröffentlichungszeitpunkt liefert published_at, den Ablaufzeitpunkt extra.expires_at; so wissen Sie genau, wie viel Zeit bis zur nächsten Erfassung bleibt.
  • Links und Erwähnungen bleiben bei der StoryZiele von Link-Stickern stehen in extra.link_urls, markierte Konten in extra.mentions – jeweils an der Story, die sie enthielt.

Parameter der Instagram Stories API

ParameterErforderlichBeschreibung
usernameErforderlichBenutzername des öffentlichen Instagram-Kontos, dessen aktuelle Stories Sie abrufen möchten. Das führende @ ist optional.

So verwenden Sie die Instagram Stories API

Senden Sie einen Benutzernamen, warten Sie, bis die Aufgabe abgeschlossen ist, und lesen Sie die Stories aus dem Aufgabenergebnis.

  1. Wählen Sie das öffentliche Konto, das Sie prüfen möchten, zum Beispiel natgeo.
  2. Senden Sie {"username": "natgeo"} per POST an /v1/instagram/stories und behalten Sie die task_id aus der Antwort.
  3. Rufen Sie alle paar Sekunden GET /v1/tasks/{task_id} auf, bis status den Wert succeeded hat.
  4. Lesen Sie die Stories in results.items; wenn results.has_more den Wert true hat, übergeben Sie results.next_cursor, um die nächste Seite zu erhalten.
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.

Anwendungsfälle der Instagram Stories API

  • Tägliches Story-Archiv: Erfassen Sie die Stories einer Marke ein- oder zweimal täglich und behalten Sie Medien und Veröffentlichungszeiten, damit jede Story auch nach ihrem Ablauf prüfbar bleibt.
  • Aktionen verfolgen: Verfolgen Sie die URLs der Link-Sticker, die Wettbewerber in ihre Stories einfügen, um zu sehen, welche Produkte, Angebote und Landingpages sie diese Woche bewerben.
  • Creator-Kampagnen prüfen: Gleichen Sie Zeitpunkt, Medien und Link-Sticker der Story eines Creators mit dem Briefing ab, um zu bestätigen, dass die vereinbarte Story online war.

Profi-Tipps zur Instagram Stories API

  • Planen Sie Durchläufe im Abstand von weniger als 24 Stunden, damit jede Story mindestens einmal erfasst wird, solange sie live ist.
  • Laden Sie die Bilder und Videos, die Sie behalten möchten, bald nach der Erfassung herunter, denn die Medien-Links von Stories sind temporäre CDN-Adressen.
  • Wenn Sie dasselbe Konto erneut erfassen, nutzen Sie die Story-ID, um bereits gespeicherte Stories zu überspringen.
  • Für Stories, die ein Konto in seinem Profil behält, verwenden Sie Instagram Story Highlights und Instagram Highlight Items.

Ergänzend zur Instagram Stories API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Instagram-Daten benötigen.

  • Instagram Posts API — Öffentliche Beiträge, Medien, Hashtags, Erwähnungen, Zeitstempel und Interaktionen per Benutzername erfassen.
  • Instagram Reels API — Öffentliche Reels, Medien, Audio, Hashtags, Erwähnungen und Interaktionen per Benutzername erfassen.
  • Instagram Profiles API — Öffentliche Profilidentität, Bios, Links, Kontomerkmale, Kategorien und sichtbare Zahlen per Benutzername abrufen.
  • Instagram Tagged Posts API — Öffentliche Beiträge erfassen, in denen ausgewählte Profile markiert sind – mit Autoren, Medien, Erwähnungen, Kontext der markierten Nutzer und Interaktionen.
  • Instagram Story Highlights API — Öffentliche Story-Highlight-Container per Benutzername auflisten – mit Titeln, Besitzerkontext, Medienanzahl und wiederverwendbaren Highlight-IDs.
  • Instagram Similar Accounts API — Die Konten auflisten, die Instagram zu einem Benutzernamen als ähnlich vorschlägt – mit Benutzernamen, Namen, Avataren und Verifizierungsstatus.

Weitere Plattformen entdecken

Kombinieren Sie Instagram-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Instagram Stories API — FAQ

Instagram Stories API ist eine Schnittstelle, die die Stories erfasst, die ein öffentliches Instagram-Konto aktuell online hat; Eingabe ist dessen Benutzername. Sie liefert zu jeder Story ID und Link, Bild oder Video, Titelbild, Autor und Veröffentlichungszeitpunkt.

Ja. Senden Sie den Benutzernamen eines öffentlichen Kontos, und seine Stories kommen als Daten zurück – auf Ihrer Seite ist keine Instagram-Anmeldung nötig.

Enthält eine Story einen Link-Sticker, wird dessen Ziel-URL für diese Story in extra.link_urls zurückgegeben.

Stories bleiben 24 Stunden online, daher genügt es, ein- oder zweimal pro Tag abzurufen, um jede Story zu erfassen, solange sie live ist.

Die Aufgabe endet mit der Meldung, dass das Profil nicht gefunden wurde, und die dafür reservierten Credits werden Ihrem Guthaben wieder gutgeschrieben.

Sie zahlen 0,5 Credits für jede zurückgegebene Story, und eine Anfrage, die keine aktuellen Stories findet, kostet nichts.