Facebook Ad Library Ad
Los anuncios de la Facebook Ad Library son registros publicitarios públicos con texto creativo, identidad del anunciante, medios, llamadas a la acción, fechas de entrega, estado activo y señales disponibles de alcance o gasto. Estos campos sirven para enriquecer anuncios seleccionados, revisar creatividades, monitorear la entrega pública y comparar el estado en un momento dado.
Funcionalidades de la Facebook Ad Library Ad API
- Resolución directa de URL de la Ad LibraryResuelve una URL pública /ads/library con un parámetro de consulta id numérico en, como máximo, un registro de anuncio normalizado.
- Contexto creativo y del anuncianteDevuelve el ID del archivo del anuncio, el título y el texto creativos, la identidad de la página del anunciante, la URL pública de la página, la llamada a la acción y el enlace de destino cuando se exponen.
- Entrega y señales visiblesConserva las horas de inicio y fin, el estado activo, las plataformas de publicación, el contexto de país, los Me gusta de la página, el alcance, la moneda y el gasto cuando el registro público los ofrece.
- Medios normalizados de varias tarjetasSelecciona el texto disponible de la instantánea o de la primera tarjeta para los campos estándar y deduplica las imágenes y los videos que aparecen en la instantánea y en las tarjetas, sin presentar una tabla completa de variantes.
Parámetros de la Facebook Ad Library Ad API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio | URL pública obligatoria de un anuncio de la Facebook Ad Library. Use la forma canónica https://www.facebook.com/ads/library/?id={numeric_id}; cada solicitud acepta una sola URL. |
Cómo usar la Facebook Ad Library Ad API
Envíe una URL pública de la Ad Library, siga la tarea asíncrona y lea el registro de anuncio normalizado en el sobre de resultados estándar.
- Prepare una URL pública de la Facebook Ad Library cuya ruta sea /ads/library y cuya consulta contenga un id numérico.
- Envíe url a /v1/facebook-ad-library/ad y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito o devuelva un error.
- Lea data.results.items; este endpoint devuelve como máximo un registro, por lo que next_cursor normalmente sigue en null y has_more sigue en false.
curl -X POST "https://api.socq.ai/v1/facebook-ad-library/ad" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.facebook.com/ads/library/?id=702369045530963"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; this operation returns at most one itemCasos de uso de la Facebook Ad Library Ad API
- Enriquecer un anuncio seleccionado: Use el ID del archivo, la identidad del anunciante, el título creativo, el texto principal, los medios, el CTA, la URL de destino y la URL de entrada para completar un registro de anuncio existente.
- Revisar recursos creativos y destinos: Inspeccione las referencias deduplicadas de imágenes o videos junto con el formato de visualización, el texto del CTA, el tipo de CTA y el enlace de destino público de un anuncio conocido.
- Revisar el contexto público de entrega: Use el estado activo, las horas de inicio y fin, las plataformas de publicación, los valores de país y los campos disponibles de alcance o gasto para examinar el contexto público de entrega.
- Conservar instantáneas de anuncios en un momento dado: Almacene los campos de creatividad, anunciante, entrega, señales visibles, URL de entrada y collected_at para comparar más adelante el mismo anuncio conocido.
Consejos de expertos para la Facebook Ad Library Ad API
- Envíe una URL de la Ad Library con la ruta exacta /ads/library y un parámetro de consulta id numérico; las URL de páginas, los ID de páginas, las URL de publicaciones y los ID de anuncio sin procesar no son entradas aceptadas.
- Trate una tarea succeeded sin registro como un resultado válido de anuncio no disponible o no encontrado cuando la URL enviada es sintácticamente válida.
- Maneje el alcance, el gasto, los Me gusta de la página, los medios, end_at, la URL del perfil del anunciante, el CTA y los valores de país como campos públicos opcionales, en lugar de convertir los valores ausentes en cero.
- En los anuncios con varias tarjetas o creatividades, use el name y el text normalizados como campos representativos e inspeccione la lista de medios deduplicada sin suponer que es una tabla completa por variante.
APIs relacionadas
Además de la Facebook Ad Library Ad API, use estas APIs cuando necesite otro tipo de datos públicos de Facebook Ad Library.
- Facebook Ad Library Search API — Busca anuncios públicos por palabra clave con controles de coincidencia, anuncio, país, estado, contenido multimedia, orden, fecha y límite de resultados.
- Facebook Ad Library Company Search API — Encuentra páginas candidatas de anunciantes por nombre de empresa o de página, con ID de página, clasificaciones, imágenes, audiencia visible y señales de Instagram vinculadas.
- Facebook Ad Library Company Ads API — Recolecta los anuncios públicos de un anunciante a partir del ID de su página, con campos de creativo, entrega, mercado, contenido multimedia, CTA y señales visibles.