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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Eine 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.
- Bereiten Sie eine oder mehrere URLs öffentlicher Instagram-Beiträge oder Reels vor.
- Senden Sie das Array urls per POST an /v1/instagram/transcript.
- Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded oder failed lautet.
- 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 trueAnwendungsfä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.
Verwandte APIs
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.
- Instagram Followers Count API
- Instagram Search API
- Instagram Comments API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Reels Search API
- Instagram Story Highlights 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