facebook-ad-library/
company-search

Busque páginas de anunciantes de la Facebook Ad Library por nombre de empresa o de página, con ID de página, categorías, imágenes y señales de audiencia de Instagram en registros normalizados.

Facebook Ad Library Company Search API

Consulta por empresa o página
Páginas candidatas de anunciantes
Señales de página y de Instagram
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 Search

Los candidatos de empresa de la Facebook Ad Library son páginas de anunciantes identificadas por ID de página, nombres, categorías, países, imágenes, valores de verificación y contexto de Instagram vinculado. Estas señales de identidad y de audiencia sirven para determinar el anunciante, comparar páginas con el mismo nombre y elegir una página de forma revisable antes de investigar anuncios.

Funcionalidades de la Facebook Ad Library Company Search API

  • Búsqueda por nombre de empresa o de páginaEnvíe una consulta no vacía con el nombre de una empresa, una marca o una página y reciba todas las páginas candidatas de anunciantes que devuelva esa búsqueda.
  • Identidad y clasificación de la páginaDevuelve los ID de página, los nombres, las URL públicas derivadas, las categorías, los países, los tipos de entidad, los valores de verificación, las imágenes y el estado de página eliminada cuando se exponen.
  • Señales visibles de la página y de InstagramConserva los Me gusta de Facebook disponibles junto con los nombres de usuario de Instagram vinculados, los conteos de seguidores y el estado de verificación en registros de candidatos normalizados.

Parámetros de la Facebook Ad Library Company Search API

ParámetrosObligatorioDescripción
queryObligatorioNombre obligatorio y no vacío de una empresa, una marca o una página pública, que se usa para encontrar páginas candidatas de anunciantes.

Cómo usar la Facebook Ad Library Company Search API

Envíe una consulta por empresa o nombre de página, siga la tarea asíncrona y revise las páginas candidatas de anunciantes normalizadas.

  1. Prepare una consulta no vacía con el nombre de una empresa, una marca o una página pública.
  2. Envíe query por POST a /v1/facebook-ad-library/company-search y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito o devuelva un error.
  4. Lea data.results.items y solicite next_cursor mientras has_more siga en true.
curl -X POST "https://api.socq.ai/v1/facebook-ad-library/company-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Example Sports"}'

# 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 Search API

  • Determinación del ID de página del anunciante: Use los ID de página, los nombres, las URL, las categorías y los países de los candidatos para elegir el identificador que requiere una solicitud de Company Ads limitada a una página.
  • Comparación de páginas con el mismo nombre y regionales: Compare las categorías, los países, los tipos de entidad, las imágenes, los valores de verificación y el contexto de Instagram vinculado entre nombres de anunciantes similares.
  • Selectores de anunciantes revisables: Almacene la identidad de la página, las señales visibles de audiencia, la consulta original y la hora de recopilación detrás de un selector de anunciantes o de un índice de investigación.

Consejos de expertos para la Facebook Ad Library Company Search API

  • Envíe solo query; Company Search no acepta results_limit ni filtros de estado, país, medios o fechas de los anuncios.
  • Cuando varios candidatos compartan un nombre conocido, compare el ID de página, la URL, la categoría, el país, la imagen, la verificación y la identidad de Instagram vinculada en lugar de elegir el primer resultado.
  • Siga next_cursor hasta que has_more sea false para que la paginación de resultados de la tarea no oculte un candidato de empresa almacenado.
  • Trate la identidad de Instagram, los conteos de seguidores, los valores de verificación, las imágenes y el estado de página eliminada como señales opcionales y maneje los campos ausentes sin rechazar al candidato.

Además de la Facebook Ad Library Company Search 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 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.
  • 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 Search API — FAQ

Facebook Ad Library Company Search API encuentra páginas candidatas de anunciantes públicos a partir de una consulta no vacía por nombre de empresa o de página. Devuelve ID de página, campos de identidad y clasificación, imágenes, métricas visibles de audiencia y contexto de Instagram vinculado.

El endpoint acepta una sola cadena query obligatoria y no vacía. No acepta results_limit ni filtros de país, estado, medios, idioma, orden o fechas de los anuncios.

No. Devuelve páginas candidatas de anunciantes y el ID numérico de página que usa Company Ads, no creatividades de anuncios ni registros de entrega.

Compare el ID de página, el nombre, la URL, la categoría, el país, el tipo de entidad, la imagen, el valor de verificación y la identidad de Instagram vinculada. Un nombre conocido por sí solo no demuestra que un candidato sea el anunciante buscado.

La búsqueda de empresas no acepta results_limit y guarda todos los ID de página únicos expuestos que devuelva la consulta. Aun así, una tarea completada puede paginar los registros almacenados con next_cursor y has_more.

Un arreglo items vacío significa que la búsqueda no devolvió ninguna página candidata pública para esa consulta. Las diferencias de nombre o la disponibilidad de la fuente pública pueden causar un resultado vacío, por lo que no prueba que la empresa no tenga anuncios.

Cada candidato de empresa devuelto cuesta 0.5 créditos de SocQ. La estimación de la solicitud usa 10 candidatos, y un conjunto de resultados vacío no genera cargo por resultado con la configuración de facturación actual.