x/
post-transcript

Trascrivi il parlato dei video di X a partire dagli URL dei loro post e ottieni le parole pronunciate come testo semplice, con la durata in secondi di ogni video e più post per richiesta.

Twitter Video Transcript API

Input con URL del post
Trascrizione in testo semplice
Durata in secondi
0,7 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
urlsObbligatorioUno 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.

  1. Invia con POST {"urls": ["https://x.com/NASA/status/2119833829389041896"]} a /v1/x/post-transcript.
  2. Interroga GET /v1/tasks/{task_id}; le trascrizioni sono pronte quando status diventa succeeded.
  3. 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.

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à.

Esplora altre piattaforme

Combina i dati di X con i dati pubblici delle altre piattaforme social supportate.

Twitter Video Transcript API — FAQ

Twitter Video Transcript API è un’interfaccia programmatica per trasformare in testo il parlato dei video di X, a partire dagli URL dei post che li contengono. Per ogni video restituisce una trascrizione in testo semplice e la durata del video in secondi.

Copia il link del post, aggiungilo a urls, che accetta più link per richiesta, e leggi la trascrizione da text quando l’attività è riuscita.

No. Ogni video restituisce una trascrizione in testo semplice con format “text” e la durata totale del video in duration_seconds; non ci sono tempi per singola riga.

Un video fino a 2 minuti costa 0,7 crediti. I video più lunghi costano 4 crediti per ogni minuto iniziato della loro durata totale, quindi un video di 3 minuti costa 12 crediti.

La trascrizione è scritta nella lingua parlata nel video. Il risultato non contiene un’etichetta della lingua, quindi rilevala da text se il tuo flusso di lavoro ne ha bisogno.

I post senza video non restituiscono alcuna riga e non vengono addebitati. Quando nessuno dei post inviati contiene un video, l’attività non riesce e viene rimborsata per intero.