x/
post-transcript

Transcrivez la parole des vidéos X à partir des URL de leurs posts : les paroles prononcées sont renvoyées en texte brut avec la durée de chaque vidéo en secondes, plusieurs posts par requête.

Twitter Video Transcript API

URL du post en entrée
Transcription en texte brut
Durée en secondes
0,7 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

Twitter Video Transcript

Les vidéos publiées sur X, anciennement Twitter, portent dans leur bande-son des interviews, des annonces, des démonstrations de produits et des commentaires, qu’une transcription convertit en texte brut accompagné de la durée de l’extrait en secondes. Une fois écrite, cette parole peut être citée mot pour mot, résumée, traduite et explorée avec les mêmes méthodes de recherche par mot-clé et par thème que les posts écrits.

Fonctionnalités de la Twitter Video Transcript API

  • Les posts vidéo à partir de leur URLTransmettez un ou plusieurs liens x.com/{username}/status/{post_id} vers des tweets contenant une vidéo : chaque vidéo renvoie une ligne avec l’id et l’url de son post.
  • La parole en texte brut continutext contient les mots prononcés dans la vidéo sous forme d’un seul bloc de texte brut, avec format à la valeur text, dans la langue utilisée par la personne qui parle.
  • La durée de la vidéo avec chaque transcriptionduration_seconds indique la durée de la vidéo, utile pour trier les extraits par longueur et pour mesurer la densité de parole d’une vidéo.

Paramètres de la Twitter Video Transcript API

ParamètresObligatoireDescription
urlsObligatoireUne ou plusieurs URL de posts X au format /{username}/status/{post_id}, chacune pointant vers un post qui contient une vidéo.

Comment utiliser la Twitter Video Transcript API

Envoyez les URL de posts vidéo et lisez une transcription par vidéo.

  1. Envoyez {"urls": ["https://x.com/NASA/status/2119833829389041896"]} en POST à /v1/x/post-transcript.
  2. Interrogez GET /v1/tasks/{task_id} ; les transcriptions sont prêtes une fois que status vaut succeeded.
  3. Lisez chaque transcription dans results.items et, lorsque has_more vaut true, récupérez la suite avec results.next_cursor.
curl -X POST "https://api.socq.ai/v1/x/post-transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/NASA/status/2119833829389041896"]}'

# Videos up to 2 minutes cost 0.7 credits; longer ones cost 4 credits per started minute.

Cas d’usage de la Twitter Video Transcript API

  • Citer ce qui a été dit dans un extrait : Copiez des phrases exactes de text et citez l’url du post, pour qu’une citation tirée d’une interview ou d’un extrait de presse puisse être vérifiée à la source.
  • Résumer et traduire des posts vidéo : Envoyez text à un outil de résumé ou à un modèle de traduction pour transformer de longs posts vidéo en notes courtes ou en d’autres langues.
  • Rechercher dans la parole de nombreuses vidéos : Indexez les transcriptions des posts vidéo d’un créateur ou d’une marque pour trouver chaque extrait qui mentionne un produit, une personne ou un sujet.
  • Publier une version texte d’une vidéo : Placez text sous la vidéo dans des articles, des newsletters ou des pages d’aide pour que les lecteurs puissent la suivre sans le son.

Conseils d’expert pour la Twitter Video Transcript API

  • Budgétez à part les longs enregistrements : une vidéo de 2 minutes maximum coûte 0,7 crédit, tandis qu’un enregistrement de 10 minutes coûte 40 crédits, facturés pour chaque minute entamée de sa durée totale.
  • Détectez la langue de text avant de l’envoyer en traduction, car chaque transcription est rédigée dans la langue parlée dans la vidéo.
  • Envoyez des listes mixtes d’URL de posts si vous ne savez pas lesquels contiennent une vidéo ; les posts vidéo renvoient une transcription et les autres ne coûtent rien, tandis qu’une liste composée uniquement de posts texte ou image échoue avec un remboursement intégral.

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

  • Twitter Tweet Scraper API — Récupérez le texte des posts publics, auteurs, l’engagement, médias, hashtags, mentions et relations de conversation à partir d’URL de statuts x.com ou twitter.com.
  • Twitter User Tweets Scraper API — Collectez par nom d’utilisateur les posts publics récents, auteurs, médias, hashtags, mentions et l’engagement, hors réponses.
  • X Post Quotes API — Collectez les citations publiques de statuts connus à partir de leur URL, avec commentaire, auteurs, engagement, médias, horodatages et contexte du post source.
  • X Post Replies API — Collectez les réponses publiques à partir d’URL de posts X avec tri au choix, texte des réponses, auteurs, engagement visible, médias et contexte du post parent.
  • Twitter Mentions API — Collectez les posts publics qui mentionnent un compte donné.
  • Twitter Media Scraper API — Collectez les posts photo, vidéo et GIF d’un compte avec les fichiers médias en qualité maximale.

Explorer d’autres plateformes

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

Twitter Video Transcript API — FAQ

Twitter Video Transcript API est une interface programmatique qui convertit en texte la parole des vidéos X, à partir des URL des posts qui les contiennent. Elle renvoie pour chaque vidéo une transcription en texte brut et la durée de la vidéo en secondes.

Copiez le lien du post, ajoutez-le à urls, qui accepte plusieurs liens par requête, et lisez la transcription dans text une fois la tâche réussie.

Non. Chaque vidéo renvoie une seule transcription en texte brut, avec format à la valeur text, et la durée totale de la vidéo dans duration_seconds ; il n’y a pas de minutage ligne par ligne.

Une vidéo de 2 minutes maximum coûte 0,7 crédit. Les vidéos plus longues coûtent 4 crédits par minute entamée de leur durée totale : une vidéo de 3 minutes coûte donc 12 crédits.

La transcription est rédigée dans la langue parlée dans la vidéo. Le résultat ne comporte aucune indication de langue : détectez-la à partir de text si votre workflow en a besoin.

Les posts sans vidéo ne renvoient aucune ligne et ne sont pas facturés. Quand aucun des posts envoyés ne contient de vidéo, la tâche échoue et est intégralement remboursée.