facebook/
ad-transcript

Extrayez les transcriptions disponibles des contenus parlés à partir d’URL de la Facebook Ad Library et obtenez le texte, la langue, le format, l’heure de collecte, les liens sources et le contexte du shortcode.

Facebook Ad Transcript API

Transcriptions de publicités
URL de l’Ad Library
Texte relié à sa source
0,5 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

Facebook Ad Transcript

Une transcription de publicité Facebook est l’enregistrement de ce qui est dit dans une publicité de l’Ad Library, avec l’URL source, le texte, la langue, le format, l’heure de collecte et, en option, le contexte du shortcode. Ces enregistrements servent à relire les messages, à indexer des mots-clés, à traiter les contenus selon leur langue et à constituer des archives reliées à leur source.

Fonctionnalités de la Facebook Ad Transcript API

  • Lots d’URL de l’Ad LibraryAccepte des URL de la Facebook Ad Library issues des hôtes Facebook pris en charge et traite chaque URL unique comme une cible de transcription indépendante.
  • Texte parlé relié à sa sourceRenvoie un texte de transcription non vide avec l’URL source envoyée et un identifiant qui reprend l’URL lorsqu’aucun ID de source n’est présent.
  • Contexte de langue et de formatL’enregistrement normalisé comprend une langue source nullable, le format plaintext ou WebVTT, l’heure de collecte et un shortcode facultatif.
  • Uniquement les enregistrements disponiblesUn résultat n’est enregistré que si la publicité visée fournit un contenu de transcription non vide : une tâche réussie peut donc renvoyer moins d’enregistrements que d’URL envoyées.

Paramètres de la Facebook Ad Transcript API

ParamètresObligatoireDescription
urlsObligatoireURL de la Facebook Ad Library sur des hôtes Facebook pris en charge, séparées par des virgules ou des retours à la ligne ; chaque chemin doit contenir /ads/library.

Comment utiliser la Facebook Ad Transcript API

Envoyez des URL de la Facebook Ad Library, puis rapprochez les URL sources renvoyées : seules les cibles dont le texte de transcription n’est pas vide produisent des éléments de résultat.

  1. Préparez une ou plusieurs URL de la Facebook Ad Library dont l’hôte est facebook.com, www.facebook.com ou m.facebook.com et dont le chemin contient /ads/library.
  2. Envoyez urls en POST à /v1/facebook/ad-transcript, puis conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
  4. Lisez data.results.items et, tant que results.has_more vaut true, demandez la page suivante avec 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}

Cas d’usage de la Facebook Ad Transcript API

  • Relecture des messages publicitaires : Lisez le texte de transcription relié à sa source pour comparer les formulations orales employées dans une sélection de publicités publiques.
  • Indexation de la parole des publicités : Indexez le texte avec les ID d’enregistrement, les URL sources, les heures de collecte et le contexte du shortcode pour retrouver par des termes prononcés les transcriptions de publicités connues.
  • Aiguillage du traitement des transcriptions : Servez-vous des champs de langue et de format pour orienter les enregistrements plaintext et WebVTT vers le bon pipeline de texte, de sous-titres ou de traitement linguistique.

Conseils d’expert pour la Facebook Ad Transcript API

  • Utilisez un hôte Facebook pris en charge et gardez /ads/library dans le chemin de chaque URL : tout autre hôte ou chemin échoue à la validation de la requête.
  • Ramenez les URL de l’Ad Library à une forme canonique avant de les regrouper en lot lorsqu’une même cible apparaît avec des chaînes de requête différentes, car le collecteur ne supprime que les chaînes strictement identiques.
  • Après un succès, comparez les valeurs url renvoyées à la liste envoyée, afin que les publicités non prises en charge et les cibles sans contenu de transcription non vide restent visibles dans votre workflow.
  • Aiguillez l’analyse selon format et traitez language et extra.shortcode comme des valeurs nullables ; created_at est réservé et renvoie actuellement null.
  • Suivez results.next_cursor tant que results.has_more vaut true lorsqu’un gros lot d’URL dépasse la limite de page de résultats demandée.

En complément de la Facebook Ad Transcript API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Facebook.

  • Facebook Pages API — Récupérez les profils de Pages publiques, leurs coordonnées, leurs images et les notes d’audience visibles.
  • Facebook Posts API — Collectez les publications publiques, médias, réactions, commentaires et partages à partir d’URL Facebook prises en charge.
  • Facebook Video Transcript API — Extrayez le texte et le format des transcriptions disponibles à partir d’URL connues de publications vidéo ou de Reels publics.
  • Facebook Group Posts API — Collectez les publications publiques à partir d’URL de groupes Facebook avec tri au choix, limites par groupe, contexte de l’auteur, médias vidéo et engagement visible.
  • Facebook Profile Photos API — Collectez les photos publiques à partir d’URL de profils ou de Pages avec légendes, contexte de l’auteur, engagement, métadonnées d’image et références sources.
  • Facebook Reels API — Collectez les Reels publics à partir d’URL de profils ou de Pages avec légendes, contexte de l’auteur, métadonnées vidéo, engagement visible et références sources.

Explorer d’autres plateformes

Combinez les données Facebook avec les données publiques d’autres plateformes sociales prises en charge.

Facebook Ad Transcript API — FAQ

Facebook Ad Transcript API est une interface programmatique qui transforme les contenus parlés d’URL de la Facebook Ad Library prises en charge en enregistrements de transcription consultables, ce qui facilite la relecture et l’indexation des messages publicitaires. Les équipes peuvent s’en servir pour la veille créative, l’archivage de mots-clés et l’analyse linguistique, à condition que la source expose un texte de transcription non vide.

Chaque élément de urls doit utiliser facebook.com, www.facebook.com ou m.facebook.com et contenir /ads/library dans son chemin. La validation n’exige pas d’ID de publicité numérique, mais la cible envoyée doit tout de même mener à un contenu de transcription pris en charge.

Chaque enregistrement normalisé contient id, platform, resource, type, url, text, language (nullable), format, created_at (toujours null), collected_at et extra.shortcode. Il n’ajoute aucun champ d’annonceur, de dépenses, de portée, de ciblage, de média créatif ou d’engagement.

Le collecteur interroge chaque URL unique séparément et n’enregistre un résultat que si la source renvoie un contenu de transcription non vide. Une cible non prise en charge ou une publicité sans texte parlé accessible ne produit donc aucun résultat fictif.

Considérez language comme nullable, car la source peut ne fournir aucune étiquette. Lisez format avant d’analyser le texte : un contenu qui commence par un en-tête WebVTT est étiqueté webvtt, et tout autre contenu de transcription est étiqueté plaintext.

L’utilisation coûte 0,5 crédit pour chaque enregistrement de transcription normalisé renvoyé. Une URL qui ne produit aucun résultat enregistré n’entraîne aucun frais par résultat dans la politique actuelle de résultat vide.