facebook/
ad-transcript

Extraiga las transcripciones de voz disponibles a partir de URL de la Facebook Ad Library, con texto, idioma, formato, hora de recopilación, enlaces de origen y contexto de shortcode.

Facebook Ad Transcript API

Transcripciones de anuncios
URL de la Ad Library
Texto con enlace de origen
0.5 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 Ad Transcript

Las transcripciones de anuncios de Facebook son registros de contenido hablado vinculados a destinos de la Ad Library, con URL de origen, texto, idioma, formato, hora de recopilación y contexto opcional de shortcode. Estos registros sirven para revisar mensajes, indexar palabras clave, procesar contenido según el idioma y mantener archivos con enlace de origen.

Funcionalidades de la Facebook Ad Transcript API

  • Lotes de URL de la Ad LibraryAcepta URL de la Facebook Ad Library de los hosts de Facebook compatibles y procesa cada URL única como un destino de transcripción independiente.
  • Texto hablado con enlace de origenDevuelve el texto de la transcripción, siempre que no esté vacío, junto con la URL de origen enviada y un identificador que recurre a la URL cuando no hay ID de origen.
  • Contexto de idioma y formatoIncluye en el registro normalizado un idioma de origen que puede ser nulo, el formato (texto sin formato o WebVTT), la hora de recopilación y un shortcode opcional.
  • Solo registros disponiblesGuarda un resultado únicamente cuando el anuncio seleccionado produce contenido de transcripción no vacío, por lo que una tarea exitosa puede devolver menos registros que URL enviadas.

Parámetros de la Facebook Ad Transcript API

ParámetrosObligatorioDescripción
urlsObligatorioURL de la Facebook Ad Library en los hosts de Facebook compatibles, separadas por comas o saltos de línea; la ruta de cada una debe contener /ads/library.

Cómo usar la Facebook Ad Transcript API

Envíe URL de la Facebook Ad Library y concilie las URL de origen devueltas, porque solo los destinos con texto de transcripción no vacío generan elementos de resultado.

  1. Prepare una o más URL de la Facebook Ad Library cuyo host sea facebook.com, www.facebook.com o m.facebook.com y cuya ruta contenga /ads/library.
  2. Envíe urls por POST a /v1/facebook/ad-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 y, cuando results.has_more sea true, solicite la página siguiente con 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}

Casos de uso de la Facebook Ad Transcript API

  • Revisión de mensajes publicitarios: Lea el texto de las transcripciones con enlace de origen para comparar las palabras usadas en un conjunto seleccionado de anuncios públicos.
  • Indexación de búsqueda del discurso de anuncios: Indexe el texto junto con los ID de registro, las URL de origen, las horas de recopilación y el contexto de shortcode para poder buscar transcripciones de anuncios conocidos por los términos hablados.
  • Enrutamiento del procesamiento de transcripciones: Use los campos de idioma y formato para dirigir los registros en texto sin formato y WebVTT al pipeline adecuado de texto, subtítulos o procesamiento de idiomas.

Consejos de expertos para la Facebook Ad Transcript API

  • Use un host de Facebook compatible y conserve /ads/library en la ruta de cada URL; otros hosts o rutas no superan la validación de la solicitud.
  • Canonice las URL de la Ad Library antes de armar los lotes cuando un mismo destino aparezca con distintas cadenas de consulta, porque el recolector solo elimina las cadenas duplicadas exactas.
  • Compare los valores url devueltos con la lista enviada una vez terminada la tarea, para que los anuncios no compatibles y los destinos sin contenido de transcripción no vacío sigan visibles en su flujo de trabajo.
  • Ramifique el análisis según format y trate language y extra.shortcode como valores que pueden ser nulos; created_at está reservado y por ahora devuelve null.
  • Siga results.next_cursor mientras results.has_more sea true cuando un lote grande de URL abarque más que el límite de resultados por página solicitado.

Además de la Facebook Ad Transcript API, use estas APIs cuando necesite otro tipo de datos públicos de Facebook.

  • Facebook Pages API — Obtiene perfiles públicos de páginas de Facebook, datos de contacto, imágenes y calificaciones visibles de la audiencia.
  • Facebook Posts API — Recolecta publicaciones públicas, contenido multimedia, reacciones, comentarios y veces compartido desde URLs de Facebook compatibles.
  • Facebook Video Transcript API — Extrae el texto de transcripción disponible y su formato desde URLs conocidas de videos o Reels públicos.
  • 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 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 Ad Transcript API — FAQ

Facebook Ad Transcript API es una interfaz programática que convierte el contenido hablado de las URL compatibles de la Facebook Ad Library en registros de transcripción con función de búsqueda, lo que facilita revisar e indexar los mensajes de los anuncios. Los equipos pueden usar esos registros para investigar creatividades, archivar palabras clave y analizar idiomas, siempre que la fuente exponga texto de transcripción no vacío.

Cada elemento de urls debe usar facebook.com, www.facebook.com o m.facebook.com e incluir /ads/library en su ruta. La validación no exige un ID de anuncio numérico, pero el destino enviado debe resolverse a contenido de transcripción compatible.

Cada registro normalizado incluye id, platform, resource, type, url, text, language (que puede ser nulo), format, created_at nulo, collected_at y extra.shortcode. No agrega campos de anunciante, gasto, alcance, segmentación, medios creativos ni interacción.

El recolector solicita cada URL única de forma independiente y guarda un registro solo cuando la fuente devuelve contenido de transcripción no vacío. Por eso, los destinos no compatibles o los anuncios sin texto hablado accesible no generan ningún resultado de relleno.

Trate language como un valor que puede ser nulo, porque la fuente quizá no proporcione una etiqueta. Lea format antes de analizar el texto: el contenido que comienza con un encabezado WebVTT se etiqueta como webvtt y el resto del contenido de transcripción se etiqueta como plaintext.

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