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ètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | URL 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.
- 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.
- Envoyez urls en POST à /v1/facebook/ad-transcript, puis conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
- 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.
API associées
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.