Facebook Video Transcript
Los registros de transcripción de videos de Facebook contienen el texto hablado de publicaciones de video y Reels públicos, con URL de origen, texto de la transcripción, formato y hora de recopilación. Estos registros sirven para indexar el habla, revisar contenido seleccionado, mantener archivos con enlace de origen y enriquecer los metadatos de publicaciones recopilados por separado.
Funcionalidades de la Facebook Video Transcript API
- Lotes de transcripciones por URL conocidaAcepta una lista de URL públicas de publicaciones de video o Reels de Facebook y elimina las cadenas duplicadas exactas antes de obtener las transcripciones.
- Registros de transcripción con enlace de origenDevuelve cada transcripción disponible con la URL de origen enviada y un ID de registro que recurre a esa URL.
- Formato de texto explícitoIdentifica el texto devuelto como plaintext o WebVTT e incluye la hora de recopilación de la transcripción para su procesamiento posterior.
- Solo resultados disponiblesCrea un registro normalizado únicamente cuando una URL pública enviada produce texto de transcripción no vacío, por lo que la cantidad de resultados puede ser menor que la de entradas.
Parámetros de la Facebook Video Transcript API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | URL públicas conocidas de publicaciones de video o Reels de Facebook, separadas por comas o saltos de línea. |
Cómo usar la Facebook Video Transcript API
Envíe URL públicas conocidas de publicaciones de video o Reels de Facebook y concilie las URL de origen devueltas, porque solo el texto de transcripción no vacío genera elementos de resultado.
- Prepare una o más URL públicas conocidas de publicaciones de video o Reels de Facebook; este endpoint no descubre el feed de videos de una página.
- Envíe urls por POST a /v1/facebook/video-transcript y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito o con error.
- Lea data.results.items, siga next_cursor mientras has_more sea true y use cada url y format al almacenar el texto.
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=50Casos de uso de la Facebook Video Transcript API
- Indexación de búsqueda de contenido hablado: Indexe el texto de la transcripción junto con su URL de origen, ID de registro, formato y hora de recopilación para poder buscar videos públicos seleccionados por las palabras habladas.
- Revisión de videos y Reels seleccionados: Use el texto de las transcripciones con enlace de origen para revisar el material hablado de un conjunto curado de URL públicas conocidas de publicaciones de video y Reels.
- Enriquecimiento de metadatos de publicaciones: Una el texto de las transcripciones con los detalles de publicaciones recopilados por separado mediante la URL de origen, cuando un conjunto de datos necesita tanto el contenido hablado como el contexto público de la publicación.
Consejos de expertos para la Facebook Video Transcript API
- Envíe URL públicas conocidas de publicaciones de video o Reels tras comprobar que cada destino es accesible; los medios mal formados, privados, eliminados o no compatibles pueden no producir ningún registro.
- Canonice las cadenas de URL antes de armar los lotes cuando un mismo video pueda aparecer con parámetros de seguimiento o formas alternativas de URL, porque el backend solo elimina los duplicados exactos.
- Compare los valores url devueltos con la lista enviada una vez terminada la tarea, para que las URL sin texto de transcripción no vacío sigan visibles en su flujo de trabajo.
- Lea format antes de analizar el texto; un registro webvtt puede conservar marcas de segmentos que no deben procesarse como texto plano sin estructura.
- Continúe con results.next_cursor mientras has_more sea true cuando un lote de URL abarque más de una página de resultados.
APIs relacionadas
Además de la Facebook Video Transcript API, use estas APIs cuando necesite otro tipo de datos públicos de Facebook.
- Facebook Posts API — Recolecta publicaciones públicas, contenido multimedia, reacciones, comentarios y veces compartido desde URLs de Facebook compatibles.
- Facebook Comments API — Recolecta comentarios públicos, autores, interacción, contenido multimedia y enlaces de origen desde URLs de publicaciones.
- Facebook Group Posts API — Recolecta publicaciones públicas desde URLs de grupos de Facebook con orden seleccionable, límites por grupo, contexto del autor, videos e interacción visible.
- Facebook Ad Transcript API — Extrae el texto hablado disponible, el idioma, el formato y el contexto de origen desde URLs de la Facebook Ad Library.
- Facebook Profile Photos API — Recolecta fotos públicas desde URLs de perfiles o páginas con descripciones, contexto del autor, interacción, metadatos de imagen y referencias de origen.
- Facebook Reels API — Recolecta Reels públicos desde URLs de perfiles o páginas con descripciones, contexto del autor, metadatos de video, interacción visible y referencias de origen.