facebook/
video-transcript

Extraiga el texto de transcripción disponible de URL públicas de publicaciones de video y Reels de Facebook, con enlaces de origen, formato y hora de recopilación en registros normalizados.

Facebook Video Transcript API

Transcripciones de video
URL conocidas
Texto con enlace de origen
0.7 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
urlsObligatorioURL 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.

  1. 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.
  2. Envíe urls por POST a /v1/facebook/video-transcript y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito o con error.
  4. 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=50

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

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.

Explorar otras plataformas

Combine los datos de Facebook con datos públicos de otras plataformas sociales compatibles.

Facebook Video Transcript API — FAQ

Facebook Video Transcript API es una interfaz programática que extrae el texto de transcripción disponible de URL públicas conocidas de publicaciones de video o Reels de Facebook. Cuando hay texto de transcripción no vacío, devuelve la URL de origen, el texto, el formato de salida y la hora de recopilación.

Envíe una lista urls no vacía con URL públicas conocidas de publicaciones de video o Reels de Facebook. La solicitud no acepta el nombre de una página, una consulta de búsqueda, un selector de idioma, un formato de transcripción ni results_limit.

Cada registro normalizado incluye id, platform, resource, type, url, text, language (que puede ser nulo), format, created_at, collected_at y extra. La respuesta no estandariza títulos de video, autores, duración, miniaturas, interacción ni marcas de tiempo de segmentos.

Un resultado solo se almacena cuando la fuente devuelve texto de transcripción no vacío. Por eso, los medios privados, eliminados, no compatibles, no disponibles o sin transcripción pueden no dejar ninguna fila de relleno.

Este endpoint no acepta ningún parámetro de idioma. El esquema normalizado reserva un campo language que puede ser nulo, pero el recolector actual de Facebook no ofrece selección de idioma ni garantiza una etiqueta del idioma de origen.

El uso cuesta 0.7 créditos por cada resultado de transcripción normalizado devuelto. Una URL de entrada que no produce ningún resultado no genera cargo por resultado según la política vigente para resultados vacíos.