Facebook Ad Library Company Ads
Los anuncios de empresas de la Facebook Ad Library son registros públicos de anunciantes con texto creativo, medios, identidad de la página, fechas de entrega, estado activo, plataformas de publicación, contexto de país y señales visibles. Estos registros sirven para monitorear anunciantes, comparar creatividades, revisar mercados específicos y elaborar informes según la hora de recopilación.
Funcionalidades de la Facebook Ad Library Company Ads API
- Recopilación por página de anuncianteUse un ID numérico de página de anunciante para que cada anuncio devuelto quede asociado con la página pública seleccionada y no con una búsqueda por palabra clave.
- Filtros de mercado y entregaAcote la recopilación por país, estado de entrega, tipo de medio, idioma, intervalo de fechas y orden compatible antes de guardar los registros.
- Campos de creatividad, medios y destinoDevuelve los títulos, el texto principal, las imágenes o videos, los valores de CTA, las URL de destino públicas y los formatos de visualización disponibles de cada anuncio.
- Contexto del anunciante y de la entregaConserva la identidad de la página, los Me gusta de la página, las fechas de entrega, el estado activo, las plataformas de publicación, los países, el alcance, la moneda y el gasto cuando se exponen públicamente.
- Registros de anuncios únicos y acotadosSigue las páginas de origen disponibles, elimina los ID de archivo o URL duplicados y se detiene en results_limit o en la última página disponible.
Parámetros de la Facebook Ad Library Company Ads API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
page_id | Obligatorio | ID numérico obligatorio de la página del anunciante en la Facebook Ad Library. Use primero Company Search cuando no conozca el ID de la página; cada tarea acepta un solo ID de página. |
results_limit | Opcional | Número máximo de anuncios únicos por guardar. El valor predeterminado es 100 y se aceptan enteros de 20 a 2,000. |
country | Opcional | Use ALL o un código de país de dos letras. El valor predeterminado es ALL. |
status | Opcional | Filtro del estado de entrega del anuncio. Use exactamente ALL, ACTIVE o INACTIVE; el valor predeterminado es ACTIVE. |
media_type | Opcional | Filtro del medio de la creatividad. Use exactamente ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME o NONE; el valor predeterminado es ALL. |
language | Opcional | Código opcional de dos letras del idioma del anuncio. |
sort_by | Opcional | Ordena los anuncios devueltos por total_impressions o relevancy_monthly_grouped; el valor predeterminado es total_impressions. |
start_date | Opcional | Fecha de inicio opcional en formato YYYY-MM-DD. No puede ser posterior a end_date. |
end_date | Opcional | Fecha de fin opcional en formato YYYY-MM-DD. No puede ser anterior a start_date. |
Cómo usar la Facebook Ad Library Company Ads API
Envíe un ID de página de anunciante con filtros opcionales, siga la tarea asíncrona y lea los registros de anuncios normalizados con paginación por cursor.
- Obtenga el ID numérico de la página del anunciante y elija los filtros de país, estado, medio, idioma, orden o fechas que necesite.
- Envíe page_id y los filtros seleccionados a /v1/facebook-ad-library/company-ads y guarde el task_id.
- Consulte /v1/tasks/{task_id} hasta que el procesamiento termine con éxito o devuelva un error.
- Lea data.results.items y solicite la página siguiente con next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/facebook-ad-library/company-ads" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"page_id":"51212153078","results_limit":100,"country":"US","status":"ACTIVE","media_type":"ALL"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la Facebook Ad Library Company Ads API
- Monitoreo de anuncios de un anunciante: Dé seguimiento a los ID de archivo, el texto creativo, los medios, el estado activo, las fechas de entrega, las URL de origen y collected_at de una página de anunciante conocida.
- Comparación de creatividades y formatos: Compare el texto, las imágenes o videos, el formato de visualización, el CTA, los enlaces de destino y el contexto de agrupación (collation) entre los anuncios devueltos de la página.
- Revisión de anuncios filtrados por mercado: Ejecute filtros de país, idioma, estado, medio y fechas para armar conjuntos de anuncios separados según preguntas definidas de mercado o de entrega.
- Informes de instantáneas de señales públicas: Combine la identidad de la página, los Me gusta de la página, el alcance, el gasto, la moneda, el estado de entrega y collected_at cuando esos valores públicos se exponen.
Consejos de expertos para la Facebook Ad Library Company Ads API
- Comience con country en ALL y filtros amplios de medios y fechas, y luego acote una condición a la vez para poder interpretar correctamente un resultado vacío.
- Use el results_limit mínimo de 20 mientras valida un ID de página y un conjunto de filtros, y auméntelo solo cuando el alcance devuelto coincida con la tarea.
- Envíe tareas separadas para las marcas con varios ID de páginas de anunciante, porque cada solicitud de Company Ads acepta un solo ID de página.
- Deduplique las ejecuciones repetidas por el id del anuncio, trate el alcance, el gasto, los medios y las fechas ausentes como no disponibles y no como cero, y use los campos de agrupación (collation) para agrupar y no para afirmar rendimiento.
APIs relacionadas
Además de la Facebook Ad Library Company Ads 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 Ad API — Recolecta un anuncio público de la Ad Library desde su URL, con campos de creativo, anunciante, contenido multimedia, entrega, CTA y señales visibles.