Facebook Video Transcript
Les transcriptions de vidéos Facebook sont des enregistrements du texte parlé dans des publications vidéo et des Reels publics, avec les URL sources, le texte de la transcription, le format et l’heure de collecte. Ces enregistrements servent à indexer la parole, à relire des contenus choisis, à constituer des archives reliées à leur source et à compléter des métadonnées de publications collectées par ailleurs.
Fonctionnalités de la Facebook Video Transcript API
- Lots de transcriptions pour des URL connuesAccepte une liste d’URL de publications vidéo ou de Reels Facebook publics et supprime les chaînes strictement identiques avant de récupérer les transcriptions.
- Enregistrements de transcription reliés à la sourceRenvoie chaque transcription disponible avec l’URL source envoyée et un ID d’enregistrement qui reprend cette URL.
- Format de texte expliciteIndique si le texte renvoyé est en plaintext ou en WebVTT et joint l’heure de collecte de la transcription pour le traitement en aval.
- Uniquement les résultats disponiblesUn enregistrement normalisé n’est créé que si une URL publique envoyée fournit un texte de transcription non vide : le nombre de résultats peut donc être inférieur au nombre d’entrées.
Paramètres de la Facebook Video Transcript API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | URL connues de publications vidéo ou de Reels Facebook publics, séparées par des virgules ou des retours à la ligne. |
Comment utiliser la Facebook Video Transcript API
Envoyez des URL connues de publications vidéo ou de Reels Facebook publics, puis rapprochez les URL sources renvoyées : seul un texte de transcription non vide produit des éléments de résultat.
- Préparez une ou plusieurs URL connues de publications vidéo ou de Reels Facebook publics ; cet endpoint ne découvre pas le fil vidéo d’une Page.
- Envoyez urls en POST à /v1/facebook/video-transcript et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
- Lisez data.results.items, suivez next_cursor tant que has_more vaut true et utilisez url et format lors du stockage du texte.
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=50Cas d’usage de la Facebook Video Transcript API
- Indexation de recherche dans le contenu parlé : Indexez le texte de transcription avec son URL source, son ID d’enregistrement, son format et son heure de collecte, pour retrouver des vidéos publiques choisies à partir de mots prononcés.
- Relecture de vidéos et de Reels choisis : Servez-vous du texte de transcription relié à sa source pour relire le contenu parlé d’une sélection d’URL connues de publications vidéo et de Reels publics.
- Enrichissement des métadonnées de publications : Joignez le texte de transcription aux détails de publications collectés séparément, par URL source, lorsqu’un jeu de données doit réunir le contenu parlé et le contexte public de la publication.
Conseils d’expert pour la Facebook Video Transcript API
- Envoyez des URL connues de publications vidéo ou de Reels publics après avoir vérifié que chaque cible est accessible ; un média mal formé, privé, supprimé ou non pris en charge peut ne produire aucun enregistrement.
- Ramenez les URL à une forme canonique avant de les regrouper en lot lorsqu’une même vidéo peut apparaître avec des paramètres de suivi ou d’autres formes d’URL, car le backend ne supprime que les doublons exacts.
- Après un succès, comparez les valeurs url renvoyées à la liste envoyée, afin que les URL sans texte de transcription non vide restent visibles dans votre workflow.
- Lisez format avant d’analyser le texte : un enregistrement webvtt peut garder un balisage de repères qu’il ne faut pas traiter comme du plaintext brut.
- Poursuivez avec results.next_cursor tant que has_more vaut true lorsqu’un lot d’URL dépasse une page de résultats.
API associées
En complément de la Facebook Video Transcript API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Facebook.
- Facebook Posts API — Collectez les publications publiques, médias, réactions, commentaires et partages à partir d’URL Facebook prises en charge.
- Facebook Comments API — Collectez les commentaires publics, leurs auteurs, l’engagement, les médias et les liens sources à partir d’URL de publications.
- 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 Ad Transcript API — Extrayez le texte parlé disponible, la langue, le format et le contexte source à partir d’URL de la Facebook Ad Library.
- 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.