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ètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Une 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.
- Envoyez {"urls": ["https://x.com/NASA/status/2119833829389041896"]} en POST à /v1/x/post-transcript.
- Interrogez GET /v1/tasks/{task_id} ; les transcriptions sont prêtes une fois que status vaut succeeded.
- 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.
API associées
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.
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- X User Replies API
- Twitter Follow Checker API