Twitter Video Transcript
I video su X, l’ex Twitter, contengono nel loro audio interviste, annunci, demo di prodotto e commenti, che una trascrizione trasforma in testo semplice abbinato alla durata della clip in secondi. Una volta messo per iscritto, quel parlato può essere citato con esattezza, riassunto, tradotto e cercato con gli stessi metodi per parole chiave e argomenti che si usano sui post scritti.
Funzionalità della Twitter Video Transcript API
- Post video tramite URLPassa uno o più link x.com/{username}/status/{post_id} a tweet con un video e ogni video restituisce una riga con l’id e l’url del suo post.
- Il parlato come testo semplice continuotext contiene le parole pronunciate nel video in un unico blocco di testo semplice, con format impostato su “text”, scritto nella lingua usata da chi parla.
- La durata del video con ogni trascrizioneduration_seconds indica la durata del video, utile per ordinare le clip per lunghezza e per misurare quanto è fitto il parlato di un video.
Parametri della Twitter Video Transcript API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Uno o più URL di post di X nel formato /{username}/status/{post_id}, ciascuno riferito a un post che contiene un video. |
Come usare la Twitter Video Transcript API
Invia gli URL dei post video e leggi una trascrizione per ogni video.
- Invia con POST {"urls": ["https://x.com/NASA/status/2119833829389041896"]} a /v1/x/post-transcript.
- Interroga GET /v1/tasks/{task_id}; le trascrizioni sono pronte quando status diventa succeeded.
- Leggi ogni trascrizione da results.items e, quando has_more è true, recupera il resto con 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.Casi d’uso della Twitter Video Transcript API
- Citare ciò che è stato detto in una clip: Copia frasi esatte da text e cita l’url del post, così una citazione tratta da un’intervista o da una clip stampa può essere verificata alla fonte.
- Riassumere e tradurre i post video: Invia text a uno strumento di sintesi o a un modello di traduzione per trasformare post video lunghi in brevi note o in altre lingue.
- Cercare nel parlato di molti video: Indicizza le trascrizioni dei post video di un creator o di un brand per trovare ogni clip che menziona un prodotto, una persona o un argomento.
- Pubblicare una versione testuale di un video: Inserisci text sotto il video in articoli, newsletter o pagine di assistenza, così chi legge può seguirlo anche senza audio.
Consigli degli esperti per la Twitter Video Transcript API
- Prevedi un budget a parte per le registrazioni lunghe: un video fino a 2 minuti costa 0,7 crediti, mentre una registrazione di 10 minuti ne costa 40, addebitati per ogni minuto iniziato della sua durata totale.
- Rileva la lingua di text prima di inviarlo alla traduzione, perché ogni trascrizione è scritta nella lingua parlata nel video.
- Invia elenchi misti di URL di post quando non sai quali post contengono un video; i post video restituiscono trascrizioni e gli altri non costano nulla, mentre un elenco composto solo da post di testo o con immagini non riesce e viene rimborsato per intero.
API correlate
Oltre alla Twitter Video Transcript API, usa queste API quando ti serve un altro tipo di dati pubblici di X.
- Twitter Tweet Scraper API — Recupera testo dei post pubblici, autori, engagement, media, hashtag, menzioni e relazioni della conversazione dagli URL di stato di x.com o twitter.com.
- Twitter User Tweets Scraper API — Raccoglie i post pubblici recenti, autori, media, hashtag, menzioni ed engagement a partire dal nome utente, escludendo le risposte.
- X Post Quotes API — Raccoglie le citazioni pubbliche di URL di stato noti con commento, autori, engagement, media, date e contesto del post di origine.
- X Post Replies API — Raccoglie le risposte pubbliche dagli URL dei post X con ordinamento selezionabile, testo delle risposte, autori, engagement visibile, media e contesto del post principale.
- Twitter Mentions API — Raccoglie i post pubblici che menzionano un account indicato.
- Twitter Media Scraper API — Raccoglie i post con foto, video e GIF di un account, con i file multimediali alla massima qualità.
- 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