instagram/
story-highlights

Öffentliche Instagram-Story-Highlight-Container zu Benutzernamen erfassen – mit Titeln, Identität des Inhabers, Medien, Anzahl der Elemente und wiederverwendbaren Highlight-IDs.

Instagram Story Highlights API

Abfrage per Benutzername
Highlight-Container
Wiederverwendbare Highlight-IDs
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 Story Highlights

Instagram Story Highlights sind gespeicherte Story-Sammlungen auf öffentlichen Profilen, geordnet nach Titeln und mit Angaben zum Inhaber, Titelmedien und der Zahl der Elemente. Diese Container-Datensätze unterstützen Bestandsaufnahmen der Profilkategorien, den Vergleich zwischen Konten und die Auswahl von Highlights für die Prüfung einzelner Elemente.

Funktionen der Instagram Story Highlights API

  • Highlight-Bestand über mehrere ProfileSenden Sie einen oder mehrere Instagram-Benutzernamen, um die öffentlichen Story-Highlight-Container jedes Kontos aufzulisten, wobei der Bezug zum Inhaber erhalten bleibt.
  • Identität und Kontext der ContainerSie erhalten normalisierte Highlight-IDs, Titel, URLs, Identität des Inhabers, direkt bereitgestellte Medien, Zeitstempel, öffentliche Zahlen und gemeldete Gesamtzahlen der Elemente.
  • Übergabe auf ElementebeneNutzen Sie extra.highlight_id, um die Zuordnung zum Container zu behalten und numerische Highlight-IDs an Workflows zur Erfassung einzelner Elemente zu übergeben.

Parameter der Instagram Story Highlights API

ParameterErforderlichBeschreibung
usernamesErforderlichEin oder mehrere öffentliche Instagram-Benutzernamen als nicht leere Handles; ein führendes @ wird akzeptiert und vor der Erfassung entfernt.

So verwenden Sie die Instagram Story Highlights API

Senden Sie Benutzernamen öffentlicher Konten als asynchrone Aufgabe, fragen Sie die Aufgaben-ID ab und lesen Sie die normalisierten Highlight-Container per Cursor-Paginierung der Ergebnisse aus.

  1. Bereiten Sie einen oder mehrere öffentliche Instagram-Benutzernamen als Handles vor, nicht als Profil-URLs.
  2. Senden Sie usernames per POST an /v1/instagram/story-highlights.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded oder failed lautet.
  4. Lesen Sie data.results.items und folgen Sie results.next_cursor, solange results.has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/instagram/story-highlights" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["instagram"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Anwendungsfälle der Instagram Story Highlights API

  • Kategorienbestand öffentlicher Profile: Ordnen Sie Highlight-Titel, Identität des Inhabers, URLs und Medienzahlen zu einem Bestand der gespeicherten Story-Kategorien, die auf einem Profil sichtbar sind.
  • Highlight-Vergleich zwischen Konten: Vergleichen Sie Container-Titel, gemeldete Gesamtzahlen der Elemente, Medienverweise und verfügbare Zeitstempel über die gesendeten öffentlichen Benutzernamen hinweg.
  • Auswahl von Story-Sammlungen: Nutzen Sie extra.highlight_id zusammen mit Titeln und media_count, um numerische Highlight-Container für den anschließenden Abruf auf Elementebene auszuwählen.

Profi-Tipps zur Instagram Story Highlights API

  • Normalisieren Sie Handles vor dem Senden, indem Sie führende @-Zeichen entfernen und die entstandenen Benutzernamen deduplizieren, denn Profil-URLs werden nicht in Handles umgewandelt.
  • Rechnen Sie mit einer Highlight-Listenanfrage pro Benutzername, ohne results_limit und ohne Fortsetzung beim Anbieter; die verfügbare Containerliste bestimmt also die erfassten Datensätze je Konto.
  • Nutzen Sie next_cursor des Aufgabenergebnisses nur zum Blättern durch die gespeicherten normalisierten Datensätze; er fordert bei Instagram keine weitere Seite von Highlights an.
  • Übergeben Sie nur vorhandene numerische Werte von extra.highlight_id an instagram/highlight-items, wenn Sie einzelne Story-Frames brauchen.
  • Behandeln Sie leere Ergebnisse als mögliches Ergebnis ohne Highlights oder mit nicht verfügbarem Profil und treffen Sie keine Annahmen über optionale Medien, Zahlen, URLs und Zeitstempel.

Ergänzend zur Instagram Story Highlights 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 Highlight Items API — Gespeicherte öffentliche Story-Elemente aus bekannten Highlight-IDs abrufen – mit Text, Autorenidentität, Medien, Zeitstempeln, sichtbaren Kennzahlen und Quellkontext.
  • Instagram Stories API — Die aktuell sichtbaren Stories eines öffentlichen Kontos per Benutzername erfassen – mit Story-Medien, Veröffentlichungszeiten und Ablaufzeiten.

Weitere Plattformen entdecken

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

Instagram Story Highlights API — FAQ

Instagram Story Highlights API ist eine Schnittstelle, die öffentliche Story-Highlight-Container zu gesendeten Instagram-Benutzernamen auflistet. Sie liefert normalisierte Container-IDs, Titel, Identität des Inhabers, Medien, öffentliche Zahlen, Anzahl der Elemente und wiederverwendbare Highlight-IDs.

Übergeben Sie ein nicht leeres Array mit Instagram-Handles. Ein führendes @ wird entfernt, Profil-URLs werden jedoch nicht in Benutzernamen umgewandelt; normalisieren und deduplizieren Sie die Handles daher vor dem Senden.

Nein. Er liefert Highlight-Container; verwenden Sie einen vorhandenen numerischen Wert von extra.highlight_id mit instagram/highlight-items, wenn Sie die einzelnen Story-Elemente eines Containers brauchen.

Ein Datensatz kann Container-ID, URL, Titel, ID des Inhabers, Benutzername und Name, direkt bereitgestellte Medien, gängige öffentliche Zahlen, created_at, collected_at, extra.highlight_id und extra.media_count enthalten.

Weder ein vom Aufrufer steuerbares results_limit noch eine Fortsetzung beim Anbieter ist umgesetzt. Jeder Benutzername wird einmal angefragt, und cursor und limit am Aufgaben-Endpunkt blättern nur durch die bereits gespeicherten normalisierten Datensätze.

Ein öffentliches Profil hat möglicherweise keine gespeicherten Highlights, oder das Konto ist privat, nicht verfügbar oder eingeschränkt. Behandeln Sie eine erfolgreiche Aufgabe mit leerem Array items als gültiges Ergebnis ohne Treffer.

Abgerechnet werden 0,5 Credits pro gespeichertem normalisiertem Highlight, ohne Grundgebühr. Schätzungen gehen von 20 Ergebnissen pro gesendetem Benutzernamen aus, während die endgültige Nutzung den tatsächlich gespeicherten Datensätzen folgt.