Google Ad Library Advertiser Search
Google Ads Transparency Center puede exponer varios registros de anunciantes para el término de búsqueda de una marca, organización o sitio web, incluidas entidades regionales o con nombres similares. Revisar sus ID, nombres, sitios web, logotipos, regiones y cantidades de anuncios disponibles ayuda a elegir el registro público de anunciante correcto antes de recopilar sus creatividades.
Funcionalidades de la Google Ad Library Advertiser Search API
- Descubrimiento de anunciantes por nombreBusque con un término no vacío de marca, organización, anunciante o sitio web y reciba candidatos de anunciantes normalizados en lugar de creatividades de anuncios.
- Contexto regional opcionalIndique una región como US para dar contexto a la búsqueda en origen, manteniendo la región separada de la geografía de entrega de los anuncios.
- Campos de identidad de los candidatosCompare el ID público del anunciante, el nombre, la URL, el sitio web, el logotipo, la región y la cantidad de anuncios informada por la fuente, sin enriquecimiento inferido.
- Almacenamiento completo de una sola respuestaAlmacena todos los anunciantes utilizables devueltos por la única respuesta de búsqueda en origen; no se aplica ningún límite de resultados controlado por quien llama ni un ciclo de paginación del proveedor.
Parámetros de la Google Ad Library Advertiser Search API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Término de búsqueda obligatorio y no vacío de anunciante, marca, organización o sitio web. El comportamiento de la coincidencia depende de la fuente y no se garantiza que sea exacto, por prefijo ni aproximado. |
region | Opcional | Cadena de región opcional y no vacía, como US, que se reenvía como contexto geográfico de la búsqueda. No demuestra dónde se entregaron los anuncios de ningún anunciante. |
Cómo usar la Google Ad Library Advertiser Search API
Envíe un término de búsqueda, siga la tarea asíncrona y revise cada candidato de anunciante normalizado antes de usar su identidad en investigaciones posteriores.
- Elija un término específico de anunciante, marca, organización o sitio web; opcionalmente, agregue una región como US.
- Envíe query y la región opcional por POST a /v1/google-ad-library/advertiser-search y guarde el task_id.
- Consulte /v1/tasks/{task_id} hasta que la tarea se complete con éxito o falle.
- Lea data.results.items y verifique la identidad de los candidatos con algo más que la similitud del nombre antes de elegir un ID de anunciante.
curl -X POST "https://api.socq.ai/v1/google-ad-library/advertiser-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Nike","region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Review data.results.items as advertiser candidatesCasos de uso de la Google Ad Library Advertiser Search API
- Resolver una marca a ID de anunciantes: Arme una lista de candidatos a partir de un nombre o un término de sitio web antes de elegir un ID de anunciante para una solicitud aparte de inventario público de anuncios.
- Separar entidades regionales o legales: Compare nombres, regiones, sitios web y páginas públicas de anunciantes cuando varios registros similares puedan representar filiales, revendedores u organizaciones sin relación.
- Crear una cola de revisión: Almacene las identidades de los candidatos y las marcas de tiempo de recopilación para su verificación manual, sin afirmar la titularidad solo por la similitud de los nombres.
Consejos de expertos para la Google Ad Library Advertiser Search API
- Use un nombre legal, una marca o un término similar a un dominio específicos; una redacción amplia puede producir candidatos ambiguos y las reglas de coincidencia no están garantizadas.
- Trate la región como contexto de búsqueda y no como evidencia de que todos los anuncios del anunciante se publicaron en esa geografía.
- Verifique los candidatos con el ID, el nombre, el sitio web, la región y su página pública de anunciante antes de combinar registros o recopilar creatividades.
- No envíe results_limit: esta operación almacena la lista de anunciantes utilizables devuelta por una sola respuesta en origen y no pagina la fuente.
APIs relacionadas
Además de la Google Ad Library Advertiser Search API, use estas APIs cuando necesite otro tipo de datos públicos de Google Ad Library.
- Google Ad Library Ad API — Obtiene un creativo público conocido del Transparency Center mediante su URL, con campos de anunciante, texto, contenido multimedia, entrega, región, formato, destino e impresiones.
- Google Ad Library Company Ads API — Recolecta creativos públicos del Transparency Center por dominio de empresa o ID de anunciante, con controles de tema, región, fecha, superficie, formato y límite de resultados.