facebook-ad-library/
company-ads

Recopile los anuncios públicos de la Facebook Ad Library de un ID de página de anunciante, con texto creativo, medios, contexto de la página, detalles de entrega y señales visibles en registros normalizados.

Facebook Ad Library Company Ads API

Entrada por ID de página del anunciante
Contexto creativo y de entrega
Registros de anuncios públicos
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 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ámetrosObligatorioDescripción
page_idObligatorioID 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_limitOpcionalNúmero máximo de anuncios únicos por guardar. El valor predeterminado es 100 y se aceptan enteros de 20 a 2,000.
countryOpcionalUse ALL o un código de país de dos letras. El valor predeterminado es ALL.
statusOpcionalFiltro del estado de entrega del anuncio. Use exactamente ALL, ACTIVE o INACTIVE; el valor predeterminado es ACTIVE.
media_typeOpcionalFiltro del medio de la creatividad. Use exactamente ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME o NONE; el valor predeterminado es ALL.
languageOpcionalCódigo opcional de dos letras del idioma del anuncio.
sort_byOpcionalOrdena los anuncios devueltos por total_impressions o relevancy_monthly_grouped; el valor predeterminado es total_impressions.
start_dateOpcionalFecha de inicio opcional en formato YYYY-MM-DD. No puede ser posterior a end_date.
end_dateOpcionalFecha 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.

  1. 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.
  2. Envíe page_id y los filtros seleccionados a /v1/facebook-ad-library/company-ads y guarde el task_id.
  3. Consulte /v1/tasks/{task_id} hasta que el procesamiento termine con éxito o devuelva un error.
  4. 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 true

Casos 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.

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.

Explorar otras plataformas

Combine los datos de Facebook Ad Library con datos públicos de otras plataformas sociales compatibles.

Facebook Ad Library Company Ads API — FAQ

Facebook Ad Library Company Ads API recupera los anuncios públicos de un ID numérico de página de anunciante. Devuelve campos normalizados de creatividad, medios, anunciante, entrega, mercado, CTA, señales visibles y hora de recopilación.

Use Facebook Ad Library Company Search con el nombre de la empresa o la marca y elija el ID numérico de página correcto entre los candidatos devueltos antes de enviar la solicitud a Company Ads.

Puede filtrar por país, estado de entrega, tipo de medio, código de idioma de dos letras y fechas de inicio y fin, y elegir uno de los dos órdenes compatibles. results_limit controla el máximo de anuncios únicos que se guardan.

La página seleccionada puede no tener anuncios públicos disponibles que coincidan con los filtros de país, estado, medio, idioma o fechas, o puede que no haya más páginas de origen disponibles. Un resultado vacío exitoso no crea anuncios de relleno.

Cada registro de anuncio devuelto cuesta 0.5 créditos de SocQ. Un conjunto de resultados vacío no genera cargo por resultado.