tiktok/
video-transcript

Extrayez les transcriptions d’URL de vidéos TikTok publiques, avec une langue facultative, et obtenez texte, langue, format, liens sources et date de collecte sous forme d’enregistrements normalisés.

TikTok Video Transcript API

Transcription vidéo
Langue facultative
Texte brut ou WebVTT
0,5 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

TikTok Video Transcript

Un enregistrement de transcription TikTok restitue la parole ou les sous-titres disponibles d’une vidéo publique, avec la langue, le format en texte brut ou WebVTT, l’URL source, le shortcode et la date de collecte. Ces données servent à chercher dans les contenus parlés, à analyser mots-clés et thèmes, à contrôler l’accessibilité et à retrouver des citations reliées à leur source.

Fonctionnalités de la TikTok Video Transcript API

  • Transcriptions pour plusieurs URLTraite en une seule tâche une ou plusieurs URL de vidéos TikTok publiques, avec une préférence de langue facultative transmise à chaque recherche.
  • Texte normalisé et provenanceRenvoie le texte de la transcription avec la langue, le format texte brut ou WebVTT, l’URL source, l’ID de l’enregistrement, le shortcode et la date de collecte, dans une structure homogène.
  • Uniquement les transcriptions disponiblesNe produit un résultat que si la source renvoie un texte de transcription non vide : la réponse distingue ainsi les transcriptions existantes, sans ligne de substitution.

Paramètres de la TikTok Video Transcript API

ParamètresObligatoireDescription
urlsObligatoireUne ou plusieurs URL de vidéos TikTok publiques résolvables, séparées par des virgules ou des retours à la ligne.
languageFacultatifLangue de transcription préférée, facultative ; utilisez un code à deux lettres, comme en, es ou fr.

Comment utiliser la TikTok Video Transcript API

Envoyez des URL de vidéos TikTok publiques connues sous forme de tâche asynchrone, interrogez son ID de tâche, puis rapprochez les transcriptions normalisées des sources demandées.

  1. Préparez une ou plusieurs URL de vidéos TikTok publiques résolvables et, si besoin, un code de langue à deux lettres, par exemple en.
  2. Envoyez urls et la langue facultative en POST à /v1/tiktok/video-transcript, puis conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed ; un succès peut tout de même contenir moins d’enregistrements que d’URL envoyées.
  4. Lisez data.results.items, associez chaque url à l’ensemble envoyé et suivez results.next_cursor tant que results.has_more vaut true.
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

Cas d’usage de la TikTok Video Transcript API

  • Archives de contenus parlés consultables : Indexez le texte des transcriptions avec URL sources, langue, format, shortcodes et date de collecte, afin de retrouver des vidéos publiques choisies à partir de mots prononcés.
  • Analyse de mots-clés et de thèmes : Analysez le texte normalisé d’un ensemble connu de vidéos pour repérer les mots, expressions et thèmes récurrents, en gardant le lien source pour la vérification.
  • Contrôle d’accessibilité et de citations : Appuyez-vous sur le texte disponible et sur les métadonnées de format pour préparer des copies lisibles ou localiser des passages, puis vérifiez-les dans la vidéo publique liée.

Conseils d’expert pour la TikTok Video Transcript API

  • Vérifiez avant l’envoi que chaque cible pointe bien vers la vidéo TikTok publique voulue : la requête accepte toute chaîne d’URL non vide, sans imposer l’hôte TikTok ni le chemin /video/{id}.
  • Ramenez les URL à leur forme canonique et retirez les variantes de suivi avant de constituer un lot, car le nettoyage des espaces et le dédoublonnage ne fusionnent que les chaînes strictement identiques.
  • Si vous choisissez une langue, indiquez un code à deux lettres comme en et orientez le traitement aval selon le champ language renvoyé, sans présumer que la préférence a été respectée.
  • Après un succès, comparez les valeurs url renvoyées à la liste envoyée, pour que les vidéos indisponibles, privées, supprimées, restreintes, sans sous-titres ou sans parole restent visibles dans votre workflow.
  • Faites varier l’analyse selon format, conservez les repères WebVTT lorsqu’ils existent et utilisez collected_at pour la traçabilité, car created_at ne contient pas la date de publication de la vidéo.

En complément de la TikTok Video Transcript API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques TikTok.

  • TikTok Profiles API — Récupérez par nom d’utilisateur l’identité publique d’un profil, ses biographies, indicateurs de compte et nombres d’audience.
  • TikTok Comments API — Collectez les commentaires publics de premier niveau, leurs auteurs, l’engagement, les mentions et les indicateurs d’interaction du créateur.
  • TikTok Videos API — Récupérez le créateur, la légende, les médias, la musique, les tags, les mentions et l’engagement à partir d’URL de vidéos.
  • TikTok User Videos API — Collectez par nom d’utilisateur les vidéos publiques du fil d’un profil avec légendes, créateurs, médias, horodatages, engagement et contexte du compte source.
  • TikTok Trending Feed API — Collectez le fil actuel de vidéos publiques d’une région avec créateur, légende, couverture, horodatage et engagement visible.
  • TikTok Song API — Récupérez les métadonnées d’un son public à partir de l’ID du clip ou de l’URL du morceau.

Explorer d’autres plateformes

Combinez les données TikTok avec les données publiques d’autres plateformes sociales prises en charge.

TikTok Video Transcript API — FAQ

TikTok Video Transcript API est une interface programmatique qui extrait le texte de transcription disponible d’une ou plusieurs URL de vidéos TikTok publiques, avec une préférence de langue facultative. Elle renvoie texte normalisé, langue, format texte brut ou WebVTT, URL source, shortcode et date de collecte lorsqu’un texte de transcription non vide existe.

Envoyez un tableau urls non vide et, si vous le souhaitez, une chaîne language. L’endpoint n’accepte ni results_limit, ni noms d’utilisateur, ni requêtes de recherche, ni réglages de téléchargement de médias, ni option de repli par IA.

Chaque enregistrement comprend id, platform, resource, type, url, text, language (nullable), format, created_at, collected_at et extra.shortcode. Il ne conserve ni descriptions de vidéos, ni auteurs, ni métriques d’engagement, ni images de couverture, ni URL de téléchargement, ni objets de segments horodatés.

Un enregistrement n’est créé que lorsque la source renvoie un texte de transcription non vide. Les vidéos sans parole ni sous-titres accessibles, ainsi que les cibles privées, supprimées, restreintes ou indisponibles, ne laissent donc aucune ligne de substitution.

Non. Indiquez une préférence à deux lettres, comme en, es ou fr, puis contrôlez le champ language renvoyé ; la disponibilité des langues et l’exactitude de la transcription dépendent de la source accessible.

Chaque enregistrement de transcription normalisé renvoyé coûte 0,5 crédit, sans frais de base. Une URL d’entrée qui ne produit aucun enregistrement n’entraîne aucun frais par résultat, selon la politique actuelle de résultat vide.