instagram/
transcript

Transkript-Datensätze aus URLs öffentlicher Instagram-Beiträge und Reels extrahieren – mit Text, Sprache, Format, Quell-URLs und Shortcodes in einer normalisierten Struktur.

Instagram Transcript API

Transkripte von Beiträgen und Reels
Plaintext oder WebVTT
Datensätze mit Quellenverweis
0,7 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 Transcript

Instagram-Transkripte sind Datensätze mit Text, der aus gesprochenem Ton in öffentlichen Beiträgen und Reels gewonnen wurde, samt Sprache, Ausgabeformat, Quell-URL, Shortcode und Erfassungszeit. Diese Datensätze unterstützen die Suche in gesprochenen Inhalten, die Prüfung der Barrierefreiheit, die Indexierung von Inhalten und Recherche mit Quellenverweis.

Funktionen der Instagram Transcript API

  • Mehrere Quell-URLsSenden Sie eine oder mehrere URLs öffentlicher Instagram-Beiträge oder Reels und erhalten Sie Transkript-Datensätze für Medien mit gesprochenem Inhalt.
  • Karussell-gerechte ErgebnisseGetrennte Transkript-Datensätze bleiben erhalten, wenn ein Karussell-Beitrag mehr als ein Medientranskript erzeugt.
  • Normalisierter Text mit HerkunftLiefert den Transkripttext mit Sprache, Format (Plaintext oder WebVTT), Quell-URL, Medienkennung, Shortcode und Erfassungszeit.

Parameter der Instagram Transcript API

ParameterErforderlichBeschreibung
urlsErforderlichEine oder mehrere URLs öffentlicher Instagram-Beiträge oder Reels, getrennt durch Kommas oder Zeilenumbrüche.

So verwenden Sie die Instagram Transcript API

Senden Sie URLs öffentlicher Instagram-Medien als asynchrone Aufgabe, fragen Sie die Aufgaben-ID ab und lesen Sie jeden normalisierten Transkript-Datensatz per Cursor-Paginierung aus.

  1. Bereiten Sie eine oder mehrere URLs öffentlicher Instagram-Beiträge oder Reels vor.
  2. Senden Sie das Array urls per POST an /v1/instagram/transcript.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded oder failed lautet.
  4. Lesen Sie /v1/tasks/{task_id}?limit=50, gleichen Sie null oder mehrere Datensätze je Eingabe-URL ab und folgen Sie results.next_cursor, solange results.has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/instagram/transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.instagram.com/reel/DHsD6HGqJhp/"]}'

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

Anwendungsfälle der Instagram Transcript API

  • Suche in gesprochenen Inhalten: Indexieren Sie den Transkripttext mit Sprache, Quell-URLs und Shortcodes, sodass sich ausgewählte öffentliche Beiträge und Reels nach gesprochenen Begriffen durchsuchen lassen.
  • Recherche zu Beiträgen und Reels: Prüfen Sie Transkripttexte über eine kuratierte URL-Menge hinweg und behalten Sie Medienkennungen und Erfassungszeit für die Quellenprüfung.
  • Prüfung von Untertiteln und Barrierefreiheit: Nutzen Sie den zurückgegebenen Text und die Formatangaben, um lesbare Fassungen vorzubereiten oder zu prüfen, ob ausgewählte öffentliche Medien verwertbare Datensätze zu gesprochenen Inhalten haben.

Profi-Tipps zur Instagram Transcript API

  • Senden Sie kanonische URLs öffentlicher Beiträge oder Reels und entfernen Sie exakte Duplikate, bevor Sie eine Aufgabe starten, damit jede beabsichtigte Quelle nur einmal verarbeitet wird.
  • Gleichen Sie Ergebnisse über die Datensatz-ID ab und nicht allein über die URL, denn stumme Medien können ohne Datensatz bleiben, und eine Karussell-URL kann mehrere liefern.
  • Verzweigen Sie die nachgelagerte Verarbeitung nach format; erhalten Sie WebVTT-Cues, wenn die Zeitstruktur wichtig ist, und behandeln Sie Plaintext als ungegliederten Text.
  • Verwenden Sie collected_at für die Herkunft der Erfassung, denn created_at wird nicht mit dem Veröffentlichungszeitpunkt des Instagram-Mediums befüllt.
  • Wenn Sie den Transkripttext in Abschnitte teilen, behalten Sie Datensatz-ID, Quell-URL, Shortcode, Sprache, Format und collected_at bei jedem abgeleiteten Segment.

Ergänzend zur Instagram Transcript 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 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 Audio Reels API — Öffentliche Reels zu einer bekannten numerischen Audio-ID erfassen – mit Bildunterschriften, Creators, Medien, Zeitstempeln, sichtbaren Interaktionen und Kontext des Quell-Audios.
  • Instagram Highlight Items API — Gespeicherte öffentliche Story-Elemente aus bekannten Highlight-IDs abrufen – mit Text, Autorenidentität, Medien, Zeitstempeln, sichtbaren Kennzahlen und Quellkontext.
  • Instagram Post Info API — Bekannte öffentliche Beitrags-, Reel- oder ältere IGTV-URLs nachschlagen – mit Bildunterschriften, Autorenidentität, Medien, Zeitstempeln, sichtbaren Interaktionen und Eingabekontext.

Weitere Plattformen entdecken

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

Instagram Transcript API — FAQ

Instagram Transcript API ist eine Schnittstelle, die Transkript-Datensätze aus URLs öffentlicher Instagram-Beiträge oder Reels extrahiert. Sie liefert Text, Sprache, das Format Plaintext oder WebVTT, Quell-URLs, Medienkennungen, Shortcodes und Erfassungszeit.

Senden Sie ein nicht leeres Array urls mit URLs öffentlicher Instagram-Beiträge oder Reels. Der Endpunkt akzeptiert weder Benutzernamen noch Suchanfragen oder ein einzelnes Feld url.

Nein. Medien ohne Sprache liefern möglicherweise keinen Transkript-Datensatz, während ein Karussell-Beitrag mehr als einen Datensatz erzeugen kann.

Nein. Dieser Endpunkt akzeptiert nur urls; die Sprache wird als Metadatum des Datensatzes zurückgegeben, wenn die Quelle sie bereitstellt.

format ist plaintext, es sei denn, der zurückgegebene Transkriptinhalt beginnt mit WebVTT-Markup; dann ist es webvtt. Datensätze können außerdem text, language, ID, Quell-URL, Shortcode, created_at als null und collected_at enthalten.

Abgerechnet werden 0,7 Credits pro zurückgegebenem Transkript-Datensatz, ohne Grundgebühr. Die Schätzung nutzt die Zahl der gesendeten URLs, während die endgültige Nutzung den tatsächlichen Datensätzen folgt, einschließlich mehrerer Datensätze aus einem Karussell.