google-ad-library/
advertiser-search

Descubra candidatos públicos de anunciantes de Google Ads Transparency Center mediante una consulta y una región opcional, con identidad, sitio web, logotipo, región y cantidad de anuncios disponible normalizados.

Google Ad Library Advertiser Search API

Candidatos de anunciantes
Contexto regional opcional
Campos de identidad estables
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

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ámetrosObligatorioDescripción
queryObligatorioTé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.
regionOpcionalCadena 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.

  1. Elija un término específico de anunciante, marca, organización o sitio web; opcionalmente, agregue una región como US.
  2. Envíe query y la región opcional por POST a /v1/google-ad-library/advertiser-search y guarde el task_id.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea se complete con éxito o falle.
  4. 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 candidates

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

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.

Explorar otras plataformas

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

Google Ad Library Advertiser Search API — FAQ

Google Ad Library Advertiser Search API es una interfaz programática para descubrir candidatos públicos de anunciantes de Google Ads Transparency Center a partir de una consulta y una región opcional. Devuelve la identidad normalizada del anunciante y los campos de sitio web, logotipo, región y cantidad de anuncios que dependen de la fuente, en lugar de creatividades de anuncios.

Devuelve solo candidatos de anunciantes. Use un ID de anunciante o un dominio verificados con la operación aparte de anuncios de empresa para enumerar las creatividades públicas.

La región es contexto geográfico que se reenvía a la búsqueda de anunciantes. Puede ayudar a acotar los candidatos, pero ni es un filtro exacto garantizado ni es evidencia de la geografía de entrega de los anuncios.

No. Es la lista completa de anunciantes utilizables devuelta por una sola respuesta de búsqueda en origen en el momento de la recopilación, sin un ciclo de paginación de SocQ ni un límite controlado por quien llama.

Cada registro de anunciante almacenado cuesta 0.5 créditos de SocQ. La estimación supone 100 resultados y admite un excedente; un resultado vacío exitoso genera solo el cargo base configurado de cero créditos.