TikTok Video Transcript
Datensätze zu TikTok-Video-Transkripten enthalten die verfügbare gesprochene Sprache oder die Untertitel öffentlicher Videos, mit Sprache, Format als Klartext oder WebVTT, Quell-URL, Shortcode und Erfassungszeitpunkt. Diese Datensätze unterstützen die Suche in gesprochenen Inhalten, die Analyse von Keywords und Themen, die Prüfung der Barrierefreiheit und die Recherche von Zitaten mit Quellenverweis.
Funktionen der TikTok Video Transcript API
- Transkript-Abfrage für mehrere URLsVerarbeiten Sie eine oder mehrere URLs öffentlicher TikTok-Videos in einer Aufgabe und geben Sie bei jeder Abfrage optional eine bevorzugte Sprache mit.
- Normalisierter Text mit HerkunftsangabenLiefert den Transkripttext mit Sprache, Format als Klartext oder WebVTT, Quell-URL, Datensatz-ID, Shortcode und Erfassungszeitpunkt in einer einheitlichen Struktur.
- Nur verfügbare DatensätzeGibt nur dann ein Ergebnis aus, wenn eine Quelle nicht leeren Transkripttext liefert, sodass die Antwort verfügbare Transkripte ohne Platzhalterzeilen unterscheidbar macht.
Parameter der TikTok Video Transcript API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Eine oder mehrere auflösbare öffentliche TikTok-Video-URLs, getrennt durch Kommas oder Zeilenumbrüche. |
language | Optional | Optionale bevorzugte Sprache des Transkripts; verwenden Sie einen zweibuchstabigen Code wie en, es oder fr. |
So verwenden Sie die TikTok Video Transcript API
Übergeben Sie bekannte öffentliche TikTok-Video-URLs als asynchrone Aufgabe, fragen Sie die Aufgaben-ID ab und gleichen Sie die normalisierten Transkript-Datensätze anschließend mit den angeforderten Quellen ab.
- Bereiten Sie eine oder mehrere auflösbare öffentliche TikTok-Video-URLs vor und, falls nötig, einen zweibuchstabigen Sprachcode wie en.
- Senden Sie urls und die optionale language per POST an /v1/tiktok/video-transcript und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis status den Wert succeeded oder failed hat; ein Erfolg kann trotzdem weniger Datensätze enthalten, als URLs übergeben wurden.
- Lesen Sie data.results.items, ordnen Sie jede url der Eingabemenge zu und folgen Sie results.next_cursor, solange results.has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/tiktok/video-transcript" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.tiktok.com/@stoolpresidente/video/7499229683859426602"],"language":"en"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der TikTok Video Transcript API
- Durchsuchbare Archive gesprochener Inhalte: Indexieren Sie den Transkripttext mit Quell-URLs, Sprache, Format, Shortcodes und Erfassungszeitpunkt, damit sich ausgewählte öffentliche Videos nach gesprochenen Begriffen durchsuchen lassen.
- Analyse von Keywords und Themen: Analysieren Sie den normalisierten Text einer bekannten Videomenge, um wiederkehrende Wörter, Wendungen und Themen zu finden, und behalten Sie dabei den Quelllink zur Prüfung.
- Prüfung von Barrierefreiheit und Zitaten: Nutzen Sie den verfügbaren Transkripttext und die Formatangaben, um lesbare Fassungen vorzubereiten oder Passagen zu finden, und prüfen Sie diese anschließend am verlinkten öffentlichen Video.
Profi-Tipps zur TikTok Video Transcript API
- Prüfen Sie vor dem Senden, ob jedes Ziel auf das gewünschte öffentliche TikTok-Video verweist, denn die Anfrage akzeptiert nicht leere URL-Zeichenfolgen, ohne den TikTok-Host oder den Pfad /video/{id} zu erzwingen.
- Kanonisieren Sie URLs und entfernen Sie Tracking-Varianten, bevor Sie sie als Stapel senden, denn Zuschneiden und Entfernen von Duplikaten fasst nur identische übergebene Zeichenfolgen zusammen.
- Wenn Sie eine Sprache wählen, verwenden Sie einen zweibuchstabigen Code wie en und steuern Sie die weitere Verarbeitung nach dem zurückgegebenen Feld language, statt davon auszugehen, dass die Präferenz erfüllt wurde.
- Vergleichen Sie nach einem Erfolg die zurückgegebenen url-Werte mit der übergebenen Liste, damit nicht verfügbare, private, gelöschte, eingeschränkte, untertitellose oder sprachlose Videos in Ihrem Workflow sichtbar bleiben.
- Verzweigen Sie das Parsing nach format, bewahren Sie WebVTT-Cues, sofern vorhanden, und nutzen Sie collected_at für die Nachverfolgung, denn created_at enthält nicht den Veröffentlichungszeitpunkt des Videos.
Verwandte APIs
Ergänzend zur TikTok Video Transcript API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher TikTok-Daten benötigen.
- TikTok Profiles API — Öffentliche Profilidentität, Bios, Kontomerkmale und Zahlen zur Zielgruppe per Benutzername abrufen.
- TikTok Comments API — Öffentliche Kommentare der obersten Ebene, Autoren, Interaktionen, Erwähnungen und Merkmale zur Creator-Interaktion erfassen.
- TikTok Videos API — Creator, Bildunterschrift, Medien, Musik, Tags, Erwähnungen und Interaktionen aus Video-URLs abrufen.
- TikTok User Videos API — Öffentliche Videos aus dem Profil-Feed per Benutzername erfassen – mit Bildunterschriften, Creators, Medien, Zeitstempeln, Interaktionen und Kontext des Quellkontos.
- TikTok Trending Feed API — Den aktuellen öffentlichen Video-Feed einer Region erfassen – mit Feldern zu Creator, Bildunterschrift, Cover, Zeitstempel und sichtbaren Interaktionen.
- TikTok Song API — Öffentliche Sound-Metadaten per Clip-ID oder Musik-URL abrufen.
- TikTok Hashtags API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info API
- TikTok Search Users API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API