facebook/
ad-transcript

Estrai le trascrizioni disponibili del parlato dagli URL della Facebook Ad Library, con testo, lingua, formato, momento della raccolta, link di origine e contesto dello shortcode.

Facebook Ad Transcript API

Trascrizioni degli annunci
URL della Ad Library
Testo collegato alla fonte
0,5 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 Ad Transcript

Facebook Ad Transcript indica i record del parlato collegati ai target della Ad Library, con URL di origine, testo, lingua, formato, momento della raccolta e contesto facoltativo dello shortcode. Questi record permettono di rivedere i messaggi, indicizzare le parole chiave, elaborare i contenuti in base alla lingua e creare archivi collegati alla fonte.

Funzionalità della Facebook Ad Transcript API

  • Batch di URL della Ad LibraryAccetta gli URL della Facebook Ad Library provenienti dagli host Facebook supportati ed elabora ogni URL univoco come target di trascrizione indipendente.
  • Parlato collegato alla fonteRestituisce il testo della trascrizione non vuoto insieme all’URL di origine inviato e a un identificatore che ricade sull’URL quando non è presente un ID di origine.
  • Contesto di lingua e formatoInclude nel record normalizzato una lingua di origine nullable, il formato plaintext o WebVTT, il momento della raccolta e uno shortcode facoltativo.
  • Solo record disponibiliSalva un risultato solo quando il target dell’annuncio selezionato produce un contenuto di trascrizione non vuoto, quindi un’attività riuscita può restituire meno record degli URL inviati.

Parametri della Facebook Ad Transcript API

ParametriObbligatorioDescrizione
urlsObbligatorioURL della Facebook Ad Library sugli host Facebook supportati, separati da virgole o a capo; ogni percorso deve contenere /ads/library.

Come usare la Facebook Ad Transcript API

Invia gli URL della Facebook Ad Library, poi confronta gli URL di origine restituiti, perché solo i target con testo di trascrizione non vuoto producono elementi di risultato.

  1. Prepara uno o più URL della Facebook Ad Library il cui host è facebook.com, www.facebook.com o m.facebook.com e il cui percorso contiene /ads/library.
  2. Invia urls con POST a /v1/facebook/ad-transcript, poi salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività ha successo o fallisce.
  4. Leggi data.results.items e, quando results.has_more è true, richiedi la pagina successiva con results.next_cursor.
curl -X POST "https://api.socq.ai/v1/facebook/ad-transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/ads/library/?id=123456789012345"]}'

# Poll GET /v1/tasks/{task_id}
# Continue with GET /v1/tasks/{task_id}?limit=50&cursor={next_cursor}

Casi d’uso della Facebook Ad Transcript API

  • Revisione dei messaggi pubblicitari: Leggi il testo delle trascrizioni collegato alla fonte per confrontare le parole usate nel parlato in un gruppo selezionato di target pubblici di annunci.
  • Indicizzazione di ricerca del parlato degli annunci: Indicizza il testo insieme a ID dei record, URL di origine, momenti di raccolta e contesto dello shortcode, così le trascrizioni di annunci noti si possono cercare per termini parlati.
  • Instradamento dell’elaborazione delle trascrizioni: Usa i campi di lingua e formato per instradare i record plaintext e WebVTT verso la pipeline appropriata di testo, sottotitoli o elaborazione linguistica.

Consigli degli esperti per la Facebook Ad Transcript API

  • Usa un host Facebook supportato e mantieni /ads/library nel percorso di ogni URL; altri host o percorsi non superano la validazione della richiesta.
  • Normalizza gli URL della Ad Library prima di creare i batch quando lo stesso target compare con stringhe di query diverse, perché il collector rimuove solo le stringhe esattamente duplicate.
  • Dopo il successo confronta i valori url restituiti con l’elenco inviato, così gli annunci non supportati e i target senza contenuto di trascrizione non vuoto restano visibili nel tuo flusso di lavoro.
  • Differenzia l’analisi in base a format e gestisci language ed extra.shortcode come valori nullable; created_at è riservato e al momento restituisce null.
  • Segui results.next_cursor finché results.has_more è true quando un batch di URL molto ampio supera il limite richiesto per pagina di risultati.

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

  • Facebook Pages API — Recupera i profili pubblici delle Pagine, i dati di contatto, le immagini e le valutazioni visibili del pubblico.
  • Facebook Posts API — Raccoglie post pubblici, media, reazioni, commenti e condivisioni da URL Facebook supportati.
  • Facebook Video Transcript API — Estrae, quando disponibili, il testo e il formato della trascrizione dagli URL pubblici di video o Reels noti.
  • 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 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 Ad Transcript API — FAQ

Facebook Ad Transcript API è un’interfaccia programmatica che trasforma il parlato degli URL supportati della Facebook Ad Library in record di trascrizione ricercabili, rendendo i messaggi pubblicitari più facili da rivedere e indicizzare. I team possono usare questi record per la ricerca creativa, l’archiviazione delle parole chiave e l’analisi linguistica, purché la fonte esponga un testo di trascrizione non vuoto.

Ogni elemento di urls deve usare facebook.com, www.facebook.com o m.facebook.com e includere /ads/library nel percorso. La validazione non richiede un ID numerico dell’annuncio, ma il target inviato deve comunque portare a un contenuto di trascrizione supportato.

Ogni record normalizzato include id, platform, resource, type, url, text, language nullable, format, created_at null, collected_at ed extra.shortcode. Non aggiunge campi su inserzionista, spesa, copertura, targeting, media creativi o engagement.

Il collector richiede ogni URL univoco in modo indipendente e salva un record solo quando la fonte restituisce un contenuto di trascrizione non vuoto. I target non supportati o gli annunci senza parlato accessibile non producono quindi alcun risultato segnaposto.

Considera language nullable, perché la fonte può non fornire un’etichetta. Leggi format prima di analizzare il testo: il contenuto che inizia con un’intestazione WebVTT è etichettato webvtt, mentre gli altri contenuti di trascrizione sono etichettati plaintext.

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