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.
| Funcionalidad | SocQ | Meta Ad Library API |
|---|---|---|
| Uso principal | Buscar anuncios públicos y obtener detalles de anunciantes o anuncios | Consultar el archivo oficial de transparencia publicitaria de Meta |
| Autenticación | Clave de API de SocQ; sin OAuth de Facebook del cliente | App de Meta, token de acceso y acceso a la Ad Library |
| Entrada inicial | Palabra clave, nombre de empresa, ID de página o URL pública de la Ad Library | Parámetros de consulta del archivo oficial e identificadores de Meta |
| Crear o administrar anuncios | No compatible | No compatible; use la Marketing API de Meta |
| Formato de respuesta | Registros normalizados de SocQ | Objetos 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. 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. 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. Leer los resultados normalizados
Procese data.results.items y siga next_cursor mientras has_more sea true.
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 trueCasos 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.
Combine datos de varias plataformas para obtener información de negocio más completa
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.
X API
Recopile perfiles públicos, relaciones de seguidores y seguidos, posts, respuestas, citas, quienes hicieron repost, resultados de búsqueda y tendencias actuales. Use resultados consistentes para investigación y monitoreo.
LinkedIn API
Obtenga datos públicos de perfiles, empresas, publicaciones y empleos de LinkedIn a partir de URL conocidas, con campos normalizados de identidad, trayectoria profesional, empresa, contenido, interacción y empleo.
Reddit API
Obtenga publicaciones y comentarios públicos de Reddit a partir de URL conocidas, explore publicaciones nuevas, principales o populares de un subreddit, o busque conversaciones por palabra clave y período de publicación.
Pinterest API
Obtenga datos de perfiles públicos de Pinterest, resuelva Pins conocidos, recopile Pins de perfiles seleccionados o busque por palabra clave para investigar creadores de contenido, contenidos y tendencias visuales.
Threads API
Obtenga perfiles públicos de Threads, resuelva publicaciones conocidas o recopile publicaciones de perfiles seleccionados con campos normalizados de identidad, contenido, multimedia, interacción y marca de tiempo.
Bluesky API
Obtenga perfiles públicos de Bluesky, resuelva URL de publicaciones conocidas o recopile una página de publicaciones de una cuenta con identidad, contenido, contenido multimedia, marcas de tiempo y campos visibles de interacción normalizados.



