tiktok/
video-transcript

Extrahieren Sie Transkripte aus URLs öffentlicher TikTok-Videos mit optionaler Sprache – mit Text, Sprache, Format, Quelllinks und Erfassungszeitpunkt als normalisierte Datensätze.

TikTok Video Transcript API

Video-Transkript
Optionale Sprache
Klartext oder WebVTT
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

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

ParameterErforderlichBeschreibung
urlsErforderlichEine oder mehrere auflösbare öffentliche TikTok-Video-URLs, getrennt durch Kommas oder Zeilenumbrüche.
languageOptionalOptionale 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.

  1. Bereiten Sie eine oder mehrere auflösbare öffentliche TikTok-Video-URLs vor und, falls nötig, einen zweibuchstabigen Sprachcode wie en.
  2. Senden Sie urls und die optionale language per POST an /v1/tiktok/video-transcript und speichern Sie die zurückgegebene task_id.
  3. 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.
  4. 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 true

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

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.

Weitere Plattformen entdecken

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

TikTok Video Transcript API — FAQ

TikTok Video Transcript API ist eine Schnittstelle zum Extrahieren verfügbarer Transkripttexte aus einer oder mehreren URLs öffentlicher TikTok-Videos mit optionaler Sprachpräferenz. Sie liefert normalisierten Text, Sprache, das Format Klartext oder WebVTT, Quell-URL, Shortcode und Erfassungszeitpunkt, sofern nicht leerer Transkripttext verfügbar ist.

Übergeben Sie ein nicht leeres Array urls und optional eine Zeichenfolge language. Der Endpunkt akzeptiert weder results_limit noch Benutzernamen, Suchanfragen, Einstellungen zum Herunterladen von Medien oder einen Schalter für einen KI-Fallback.

Jeder Datensatz enthält id, platform, resource, type, url, text, das nullable Feld language, format, created_at, collected_at und extra.shortcode. Videobeschreibungen, Autoren, Interaktionskennzahlen, Titelbilder, Download-URLs und zeitgesteuerte Segmentobjekte werden nicht übernommen.

Ein Datensatz entsteht nur, wenn die Quelle nicht leeren Transkripttext liefert. Videos ohne zugängliche gesprochene Sprache oder Untertitel sowie private, gelöschte, eingeschränkte oder nicht verfügbare Ziele können daher ohne Platzhalterzeile bleiben.

Nein. Verwenden Sie eine zweibuchstabige Präferenz wie en, es oder fr und prüfen Sie dann das zurückgegebene Feld language; die Verfügbarkeit von Sprachen und die Genauigkeit des Transkripts hängen von der zugänglichen Quelle ab.

Die Nutzung kostet 0,5 Credits pro zurückgegebenem normalisiertem Transkript-Datensatz, ohne Grundgebühr. Für eine Eingabe-URL, die keinen Datensatz erzeugt, fällt nach der aktuellen Regel für leere Ergebnisse keine Gebühr pro Ergebnis an.