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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
usernames | Erforderlich | Ein 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.
- Bereiten Sie einen oder mehrere öffentliche Instagram-Benutzernamen als Handles vor, nicht als Profil-URLs.
- Senden Sie usernames per POST an /v1/instagram/story-highlights.
- Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded oder failed lautet.
- 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 trueAnwendungsfä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.
Verwandte APIs
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.
- 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 Post Info API
- Instagram Reels Search API
- Instagram Trending Reels 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