Instagram Highlight Items
Instagram Highlight Items sind Story-Einträge, die in den Highlights öffentlicher Profile gespeichert sind, mit Text, Autorenidentität, Medienverweisen, Zeitstempeln und sichtbaren Interaktionssignalen. Diese Datensätze unterstützen Inhaltsinventare von Highlights, Medienprüfung, quellenbezogenes Reporting und den Vergleich bekannter Highlights.
Funktionen der Instagram Highlight Items API
- Eingabe mehrerer HighlightsÜbergeben Sie eine oder mehrere numerische Highlight-IDs; für jede übergebene Kennung erfolgt eine eigene Abfrage bei der Quelle.
- Normalisierte Story-Element-DatensätzeSie erhalten Element-IDs, öffentliche URLs, Titel- oder Bildunterschriftentext, Autorenidentität, sichtbare Kennzahlen, Metadaten der Medien und Zeitstempel in einer einheitlichen Datensatzform.
- Zuordnung zum Quell-HighlightJedes zurückgegebene Element behält die übergebene Highlight-ID in extra.highlight_id, sodass Datensätze aus mehreren Highlights unterscheidbar bleiben.
Parameter der Instagram Highlight Items API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
highlight_ids | Erforderlich | Eine oder mehrere bekannte Instagram-Highlight-IDs als nicht leere numerische Zeichenfolgen, getrennt durch Kommas oder Zeilenumbrüche. |
So verwenden Sie die Instagram Highlight Items API
Senden Sie bekannte Highlight-IDs als asynchrone Aufgabe, fragen Sie die Aufgaben-ID ab und lesen Sie die gespeicherten normalisierten Datensätze per Cursor-Paginierung der Ergebnisse aus.
- Bereiten Sie eine oder mehrere aktuelle numerische Highlight-IDs vor; ist eine ID unbekannt, erfassen Sie zuerst die Story Highlights per Benutzername und lesen extra.highlight_id aus dem zurückgegebenen Container-Datensatz.
- Senden Sie highlight_ids per POST an /v1/instagram/highlight-items.
- Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded oder failed lautet.
- Lesen Sie /v1/tasks/{task_id}?limit=50 und folgen Sie results.next_cursor, solange results.has_more den Wert true hat.
# Replace the documented sample with a current highlight ID before running.
curl -X POST "https://api.socq.ai/v1/instagram/highlight-items" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"highlight_ids":["18067016518767507"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der Instagram Highlight Items API
- Inventar gespeicherter Story-Inhalte: Ordnen Sie zurückgegebene Element-IDs, Texte, öffentliche URLs, Medienverweise und Zeitstempel zu einem prüfbaren Inventar für bekannte Highlights.
- Medienprüfung von Highlights: Prüfen Sie Bild- oder Video-URLs, Vorschaubilder, Abmessungen, Dauer, Bildunterschriften und Autorenkontext der Story-Elemente, die ein Highlight aktuell bereitstellt.
- Vergleich zwischen Highlights: Gruppieren Sie die Datensätze nach extra.highlight_id und vergleichen Sie zurückgegebene Inhaltstypen, Veröffentlichungszeiten, Autoren und sichtbare Kennzahlen über ausgewählte Highlights hinweg.
Profi-Tipps zur Instagram Highlight Items API
- Sind Highlight-IDs unbekannt, rufen Sie zuerst instagram/story-highlights per Benutzername auf und verwenden extra.highlight_id aus erfolgreichen Ergebnissen; dieser Endpunkt ermittelt keine IDs aus Benutzernamen.
- Entfernen Sie doppelte IDs vor dem Senden, denn der Collector führt für jeden übergebenen Wert eine eigene Abfrage aus.
- Fügen Sie kein results_limit hinzu; jede Highlight-ID liefert die Elemente, die in ihrer einen Antwort der Quelle verfügbar sind.
- Unterscheiden Sie highlight-items und story-highlights über resource, denn beide Familien normalisierter Datensätze verwenden den Typ story.
- Behandeln Sie Text, Autorenfelder, Kennzahlen, Medien, URLs und Zeitstempel als optional und lassen Sie zu, dass nicht verfügbare oder entfernte Story-Elemente keinen Datensatz erzeugen.
- Folgen Sie results.next_cursor nur, um weitere gespeicherte Datensätze der Aufgabe zu lesen; es setzt die Erfassung bei Instagram nicht fort.
Verwandte APIs
Ergänzend zur Instagram Highlight Items 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 Transcript API — Transkripttext, Sprache, Format, Quell-URLs und Shortcodes aus öffentlichen Beitrags- oder Reel-URLs extrahieren.
- Instagram Story Highlights API — Öffentliche Story-Highlight-Container per Benutzername auflisten – mit Titeln, Besitzerkontext, Medienanzahl und wiederverwendbaren Highlight-IDs.
- Instagram Followers Count API
- Instagram Search API
- Instagram Comments API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Audio Reels API
- Instagram Post Info API
- Instagram Reels Search API
- Instagram Trending Reels API
- Instagram Stories 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