Volver a las API
Datos independientes de la Facebook Ad Library

Facebook Ad Library API

Busque anuncios públicos de Facebook por palabra clave, encuentre páginas de anunciantes, obtenga los anuncios de un ID de página o consulte un anuncio conocido con campos normalizados de creatividad, contenido multimedia, entrega, CTA y destino.

API de la Facebook Ad Library disponibles

Use Search para descubrir anuncios por palabra clave, Company Search para encontrar un ID de página, Company Ads para obtener los anuncios de esa página o Ad Details para consultar un anuncio público conocido.

¿Qué datos de la Facebook Ad Library se pueden obtener?

SocQ devuelve registros públicos normalizados de anuncios y anunciantes para investigar creatividades, monitorear a la competencia, analizar campañas y armar conjuntos de datos publicitarios.

Resultados de búsqueda de anuncios

Busque anuncios públicos por palabra clave o frase exacta, con filtros opcionales de país, estado, contenido multimedia, tipo de anuncio, fecha, orden y límite de resultados.

Registros de páginas de anunciantes

Encuentre ID de página, nombres, URL, categorías, países, imágenes, valores de verificación, Me gusta visibles de la página y el contexto de Instagram vinculado.

Colecciones de anuncios por página

Obtenga un conjunto acotado de anuncios públicos únicos de un ID numérico de página de anunciante, con filtros opcionales de entrega y contenido multimedia.

Texto y contenido multimedia de la creatividad

Obtenga los títulos, el texto principal, las descripciones de enlaces y los formatos de visualización de los anuncios, junto con referencias públicas de imágenes o videos sin duplicados.

Contexto de entrega y de mercado

Conserve las horas de inicio y fin, el estado activo, las plataformas de publicación, los países, el alcance, la moneda, el gasto y las señales de Me gusta de la página que estén disponibles.

Llamadas a la acción y destinos

Obtenga el texto y el tipo de CTA visibles, las URL públicas de destino, las URL de la Ad Library, la identidad del anunciante y las marcas de tiempo de recolección cuando estén expuestas.

SocQ vs Meta Ad Library API

SocQ ofrece flujos listos para usar de recolección de anuncios públicos. La Ad Library API de Meta es la opción oficial para el acceso directo al archivo de transparencia publicitaria de Meta.

FuncionalidadSocQMeta Ad Library API
Uso principalBuscar anuncios públicos y obtener detalles de anunciantes o anunciosConsultar el archivo oficial de transparencia publicitaria de Meta
AutenticaciónClave de API de SocQ; sin OAuth de Facebook del clienteApp de Meta, token de acceso y acceso a la Ad Library
Entrada inicialPalabra clave, nombre de empresa, ID de página o URL pública de la Ad LibraryParámetros de consulta del archivo oficial e identificadores de Meta
Crear o administrar anunciosNo compatibleNo compatible; use la Marketing API de Meta
Formato de respuestaRegistros normalizados de SocQObjetos nativos de la Graph API de Meta

Cómo funciona la Facebook Ad Library API

Las cuatro API usan el mismo flujo de tareas asíncronas y de resultados paginados.

  1. 1. Elegir la API y la entrada

    Comience con una palabra clave, un nombre de empresa, un ID numérico de página o una URL pública de /ads/library, según el registro que necesite.

  2. 2. Enviar y dar seguimiento a la tarea

    Envíe la solicitud POST correspondiente, guarde el task_id devuelto y consulte /v1/tasks/{task_id} hasta que el procesamiento termine.

  3. 3. Leer los resultados normalizados

    Procese data.results.items y siga next_cursor mientras has_more sea true.

Buscar anuncios públicos por palabra clave

Autentíquese con su clave de API de SocQ y envíe una palabra clave al endpoint Search. Las demás API de la Ad Library usan el mismo flujo de tareas.

curl -X POST "https://api.socq.ai/v1/facebook-ad-library/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"running shoes","results_limit":100,"status":"ACTIVE"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso frecuentes de la Facebook Ad Library API

Monitoreo de anuncios de la competencia

Dé seguimiento a los anuncios públicos de páginas de anunciantes seleccionadas y compare con el tiempo la creatividad, el contenido multimedia, el estado de entrega, los mercados, los CTA y los destinos.

Investigación de creatividades y mensajes

Busque términos de productos, categorías o marcas para revisar el texto de los anuncios públicos, los formatos, el contenido multimedia, las llamadas a la acción y los destinos de las páginas de aterrizaje.

Descubrimiento de anunciantes

Convierta nombres de empresas o marcas en ID de páginas públicas y campos de identidad antes de obtener un conjunto de anuncios específico de una página.

Conjuntos de datos publicitarios

Almacene para su análisis ID de anuncios normalizados, registros de anunciantes, campos de creatividad, contexto de entrega, URL de origen y marcas de tiempo collected_at.

Límites y política de datos públicos

Los resultados de la Facebook Ad Library son registros públicos de un momento dado. Estas API no administran cuentas publicitarias ni ofrecen datos privados de rendimiento de campañas.

  • Search requiere una query no vacía; results_limit tiene un valor predeterminado de 100 y acepta enteros de 20 a 2,000.
  • Company Search acepta una sola consulta con el nombre de una empresa o página, no acepta results_limit y puede devolver varias páginas candidatas con nombres parecidos.
  • Company Ads requiere un único ID numérico de página; results_limit acepta de 20 a 2,000 y los filtros pueden reducir la cantidad de registros devueltos.
  • Ad Details acepta una URL pública de facebook.com/ads/library con un id numérico y devuelve como máximo un registro de anuncio normalizado.
  • Una tarea completada puede no devolver registros cuando un anuncio, una página o el conjunto de resultados filtrado no está disponible en la fuente pública.
  • Los campos de alcance, gasto, moneda, contenido multimedia, fechas, CTA, destino y anunciante pueden estar ausentes y no deben interpretarse como cero.

Preguntas frecuentes sobre la Facebook Ad Library API

¿Qué es la Facebook Ad Library API?

La Facebook Ad Library API es un conjunto de endpoints de SocQ para buscar anuncios públicos, encontrar páginas de anunciantes, obtener los anuncios de una página específica y consultar los detalles de anuncios públicos conocidos.

¿Qué API de la Facebook Ad Library debo usar?

Use Search para descubrir anuncios por palabra clave, Company Search para encontrar un ID de página, Company Ads para obtener los anuncios de ese ID y Ad Details para una URL pública conocida de la Ad Library.

¿Qué se puede buscar y filtrar?

Search acepta una palabra clave o una frase exacta, además de filtros opcionales de país, estado, contenido multimedia, tipo de anuncio, fecha, orden y límite de resultados. Company Ads admite filtros de entrega y de contenido multimedia específicos de una página.

¿Qué datos públicos de anuncios se devuelven?

Los resultados pueden incluir la identidad del anuncio y del anunciante, el texto de la creatividad, imágenes o videos, fechas de entrega, estado activo, plataformas de publicación, países, CTA, destino y señales públicas visibles.

¿Por qué una solicitud completada puede no devolver resultados?

Es posible que la fuente pública no tenga coincidencias para la entrada enviada, que los filtros excluyan todos los registros o que el anuncio o la página solicitados ya no estén disponibles públicamente.

¿Es lo mismo que la API de datos sociales de Facebook o la API de Marketplace?

No. Los endpoints de la Facebook Ad Library son independientes de las API de SocQ para páginas, publicaciones y comentarios de Facebook, y de sus API de artículos de Facebook Marketplace.

¿Cuánto cuestan los resultados de la Facebook Ad Library?

Los anuncios de Search, los candidatos de Company Search y los registros de Company Ads cuestan 0.5 créditos por resultado devuelto. Ad Details cuesta 0.6 créditos por resultado devuelto, y los resultados vacíos no tienen cargo.

Reúna en un mismo flujo de trabajo perfiles públicos, contenido y datos de interacción de distintas plataformas para dar seguimiento a marcas, creadores y temas, y para realizar monitoreo y análisis entre plataformas con más eficiencia.