facebook/
video-transcript

Extrayez le texte de transcription disponible à partir d’URL de publications vidéo et de Reels Facebook publics et obtenez liens sources, format et heure de collecte sous forme d’enregistrements normalisés.

Facebook Video Transcript API

Transcriptions de vidéos
URL connues
Texte relié à sa source
0,7 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 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ètresObligatoireDescription
urlsObligatoireURL 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.

  1. 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.
  2. Envoyez urls en POST à /v1/facebook/video-transcript et 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, 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=50

Cas 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.

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.

Explorer d’autres plateformes

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

Facebook Video Transcript API — FAQ

Facebook Video Transcript API est une interface programmatique qui extrait le texte de transcription disponible d’URL connues de publications vidéo ou de Reels Facebook publics. Lorsqu’un texte de transcription non vide existe, elle renvoie l’URL source, le texte, le format de sortie et l’heure de collecte.

Envoyez un tableau urls non vide contenant des URL connues de publications vidéo ou de Reels Facebook publics. La requête n’accepte ni nom de Page, ni requête de recherche, ni sélecteur de langue, ni format de transcription, ni results_limit.

Chaque enregistrement normalisé contient id, platform, resource, type, url, text, language (nullable), format, created_at, collected_at et extra. La réponse ne normalise pas les titres de vidéos, les auteurs, la durée, les miniatures, l’engagement ni les horodatages de segments.

Un résultat n’est stocké que si la source renvoie un texte de transcription non vide. Un média privé, supprimé, non pris en charge, indisponible ou sans transcription ne laisse donc aucune ligne fictive.

Cet endpoint n’accepte aucun paramètre de langue. Le schéma normalisé réserve un champ language nullable, mais le collecteur Facebook actuel ne propose pas de sélection de langue et ne garantit pas d’étiquette de langue source.

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