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ámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Nombre 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.
- Prepare una consulta no vacía con el nombre de una empresa, una marca o una página pública.
- Envíe query por POST a /v1/facebook-ad-library/company-search 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 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 trueCasos 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.
APIs relacionadas
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.