instagram/
highlight-items

Öffentliche Story-Elemente aus bekannten Instagram-Highlight-IDs als normalisierte Datensätze abrufen – mit Text, Autorenidentität, sichtbaren Kennzahlen, Mediendetails und Quellkontext.

Instagram Highlight Items API

Bekannte Highlight-IDs
Story-Element-Datensätze
Medien und Quellkontext
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 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

ParameterErforderlichBeschreibung
highlight_idsErforderlichEine 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.

  1. 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.
  2. Senden Sie highlight_ids per POST an /v1/instagram/highlight-items.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded oder failed lautet.
  4. 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 true

Anwendungsfä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.

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.

Weitere Plattformen entdecken

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

Instagram Highlight Items API — FAQ

Instagram Highlight Items API ist eine Schnittstelle zum Abrufen öffentlicher Story-Elemente anhand bekannter numerischer Instagram-Highlight-IDs. Sie liefert normalisierte Element-Identität, Text, Autoren, sichtbare Kennzahlen, Medienmetadaten, Zeitstempel und den Kontext des Quell-Highlights.

Verwenden Sie eine bekannte aktuelle Highlight-ID oder erfassen Sie zuerst die Story Highlights per Benutzername. Erfolgreiche Ergebnisse von instagram/story-highlights zeigen die Quellkennung als extra.highlight_id, sofern sie verfügbar ist; dieser Endpunkt akzeptiert keine Benutzernamen.

Ein normalisiertes Element kann ID, URL, Text, Autoren-ID, Benutzernamen und Namen, sichtbare Kennzahlen, Bild- oder Videometadaten, created_at, collected_at und extra.highlight_id enthalten. Die Verfügbarkeit der Felder richtet sich nach der öffentlichen Antwort der Quelle.

Ein results_limit wird nicht akzeptiert, und der Collector stellt pro Highlight-ID eine Anfrage an die Quelle. Der Ergebnis-Endpunkt der Aufgabe kann gespeicherte Datensätze trotzdem mit limit und results.next_cursor paginieren.

Ein Highlight enthält möglicherweise keine aktuell bereitgestellten Datensätze, oder seine Story-Elemente wurden entfernt, eingeschränkt, auf privat gesetzt oder sind nicht mehr verfügbar. Die Aufgabe speichert nur Datensätze, die in der aktuellen öffentlichen Antwort vorhanden sind.

Die Abrechnung beträgt 0,5 Credits pro zurückgegebenem normalisiertem Datensatz, ohne Grundgebühr. Die Schätzung geht von 20 Datensätzen pro übergebener Highlight-ID aus, die endgültige Nutzung richtet sich nach den tatsächlich zurückgegebenen Datensätzen.