facebook/
video-transcript

Estrai il testo disponibile delle trascrizioni dagli URL pubblici di post video e Reel di Facebook, con link di origine, formato e momento della raccolta come record normalizzati.

Facebook Video Transcript API

Trascrizioni dei video
URL noti
Testo collegato alla fonte
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

Facebook Video Transcript

I record di Facebook Video Transcript contengono il testo parlato dei post video e dei Reel pubblici, con URL di origine, testo della trascrizione, formato e momento della raccolta. Questi record supportano l’indicizzazione del parlato, la revisione di contenuti selezionati, gli archivi collegati alla fonte e l’arricchimento insieme ai metadati dei post raccolti separatamente.

Funzionalità della Facebook Video Transcript API

  • Batch di trascrizioni da URL notiAccetta un elenco di URL pubblici di post video o Reel di Facebook e rimuove le stringhe esattamente duplicate prima del recupero delle trascrizioni.
  • Record di trascrizione collegati alla fonteRestituisce ogni trascrizione disponibile con l’URL di origine inviato e un ID del record che ricade su quell’URL.
  • Formato del testo esplicitoIdentifica il testo restituito come plaintext o WebVTT e include il momento di raccolta della trascrizione per la gestione a valle.
  • Solo risultati disponibiliCrea un record normalizzato solo quando un URL pubblico inviato produce un testo di trascrizione non vuoto, quindi il numero di risultati può essere inferiore a quello degli input.

Parametri della Facebook Video Transcript API

ParametriObbligatorioDescrizione
urlsObbligatorioURL pubblici noti di post video o Reel di Facebook, separati da virgole o a capo.

Come usare la Facebook Video Transcript API

Invia gli URL pubblici noti di post video o Reel di Facebook, poi confronta gli URL di origine restituiti, perché solo un testo di trascrizione non vuoto produce elementi di risultato.

  1. Prepara uno o più URL pubblici noti di post video o Reel di Facebook; questo endpoint non scopre il feed video di una pagina.
  2. Invia urls con POST a /v1/facebook/video-transcript e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività ha successo o fallisce.
  4. Leggi data.results.items, segui next_cursor finché has_more è true e usa url e format di ogni record quando salvi il testo.
curl -X POST "https://api.socq.ai/v1/facebook/video-transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/reel/1535656380759655"]}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

Casi d’uso della Facebook Video Transcript API

  • Indicizzazione di ricerca dei contenuti parlati: Indicizza il testo delle trascrizioni con URL di origine, ID del record, formato e momento di raccolta, così i video pubblici selezionati si possono cercare per parole pronunciate.
  • Revisione di video e Reel selezionati: Usa il testo delle trascrizioni collegato alla fonte per rivedere il materiale parlato in un gruppo curato di URL pubblici noti di post video e Reel.
  • Arricchimento dei metadati dei post: Unisci il testo delle trascrizioni ai dettagli dei post raccolti separatamente tramite l’URL di origine, quando un dataset richiede sia il contenuto parlato sia il contesto del post pubblico.

Consigli degli esperti per la Facebook Video Transcript API

  • Invia URL pubblici noti di post video o Reel dopo aver verificato che ogni target sia raggiungibile; i media malformati, privati, rimossi o non supportati possono non produrre alcun record.
  • Normalizza le stringhe URL prima di creare i batch quando lo stesso video può comparire con parametri di tracciamento o forme alternative di URL, perché il backend rimuove solo i duplicati esatti.
  • Dopo il successo confronta i valori url restituiti con l’elenco inviato, così gli URL senza testo di trascrizione non vuoto restano visibili nel tuo flusso di lavoro.
  • Leggi format prima di analizzare il testo; un record webvtt può conservare marcatori di cue che non vanno elaborati come plaintext non strutturato.
  • Prosegui con results.next_cursor finché has_more è true quando un batch di URL occupa più di una pagina di risultati.

Oltre alla Facebook Video Transcript API, usa queste API quando ti serve un altro tipo di dati pubblici di Facebook.

  • Facebook Posts API — Raccoglie post pubblici, media, reazioni, commenti e condivisioni da URL Facebook supportati.
  • Facebook Comments API — Raccoglie commenti pubblici, autori, engagement, media e link alla fonte a partire dagli URL dei post.
  • Facebook Group Posts API — Raccoglie i post pubblici dagli URL dei gruppi Facebook con ordinamento selezionabile, limiti per gruppo, contesto dell’autore, video ed engagement visibile.
  • Facebook Ad Transcript API — Estrae, quando disponibili, il testo parlato, la lingua, il formato e il contesto della fonte dagli URL della Facebook Ad Library.
  • Facebook Profile Photos API — Raccoglie le foto pubbliche dagli URL di profili o Pagine con didascalie, contesto dell’autore, engagement, metadati delle immagini e riferimenti alla fonte.
  • Facebook Reels API — Raccoglie i Reels pubblici dagli URL di profili o Pagine con didascalie, contesto dell’autore, metadati dei video, engagement visibile e riferimenti alla fonte.

Esplora altre piattaforme

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

Facebook Video Transcript API — FAQ

Facebook Video Transcript API è un’interfaccia programmatica per estrarre il testo disponibile delle trascrizioni da URL pubblici noti di post video o Reel di Facebook. Quando è disponibile un testo di trascrizione non vuoto, restituisce URL di origine, testo, formato di output e momento della raccolta.

Invia un array urls non vuoto con URL pubblici noti di post video o Reel di Facebook. La richiesta non accetta il nome di una pagina, una query di ricerca, un selettore di lingua, un formato di trascrizione né results_limit.

Ogni record normalizzato include id, platform, resource, type, url, text, language nullable, format, created_at, collected_at ed extra. La risposta non standardizza titoli dei video, autori, durata, miniature, engagement né timestamp dei segmenti.

Un risultato viene salvato solo quando la fonte restituisce un testo di trascrizione non vuoto. I media privati, rimossi, non supportati, non disponibili o senza trascrizione possono quindi non lasciare alcuna riga segnaposto.

Questo endpoint non accetta alcun parametro di lingua. Lo schema normalizzato riserva un campo language nullable, ma l’attuale collector di Facebook non offre la selezione della lingua né garantisce un’etichetta della lingua di origine.

L’utilizzo costa 0,7 crediti per ogni risultato di trascrizione normalizzato restituito. Un URL di input che non produce alcun risultato non comporta alcun addebito per risultato con l’attuale policy sui risultati vuoti.