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ètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Une ou plusieurs URL de vidéos TikTok publiques résolvables, séparées par des virgules ou des retours à la ligne. |
language | Facultatif | Langue 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.
- 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.
- Envoyez urls et la langue facultative en POST à /v1/tiktok/video-transcript, puis conservez le task_id renvoyé.
- 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.
- 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 trueCas 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.
API associées
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.
- 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