google-ad-library/
advertiser-search

Repérez des annonceurs candidats du Google Ads Transparency Center à partir d’une requête et d’une région facultative, avec identité normalisée, site web, logo, région et nombre de publicités disponible.

Google Ad Library Advertiser Search API

Annonceurs candidats
Région facultative
Champs d’identité stables
0,5 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

Google Ad Library Advertiser Search

Le Google Ads Transparency Center peut exposer plusieurs fiches d’annonceurs pour un terme de recherche portant sur une marque, une organisation ou un site web, y compris des entités régionales ou aux noms proches. L’examen de leurs ID, noms, sites web, logos, régions et nombres de publicités disponibles aide à choisir la bonne fiche d’annonceur public avant de collecter ses publicités.

Fonctionnalités de la Google Ad Library Advertiser Search API

  • Découverte d’annonceurs par leur nomCherchez avec un terme non vide désignant une marque, une organisation, un annonceur ou un site web, et recevez des annonceurs candidats normalisés plutôt que des publicités.
  • Contexte régional facultatifTransmettez une région comme US pour contextualiser la recherche en amont, la région restant distincte de la géographie de diffusion des publicités.
  • Champs d’identité des candidatsComparez l’ID public de l’annonceur, son nom, son URL, son site web, son logo, sa région et le nombre de publicités déclaré par la source, sans enrichissement déduit.
  • Stockage complet d’une réponse uniqueTous les annonceurs exploitables renvoyés par la réponse de recherche en amont sont stockés ; aucune limite de résultats contrôlée par l’appelant ni boucle de pagination du fournisseur n’est appliquée.

Paramètres de la Google Ad Library Advertiser Search API

ParamètresObligatoireDescription
queryObligatoireTerme de recherche obligatoire et non vide : annonceur, marque, organisation ou site web. Le mode de correspondance dépend de la source et n’est garanti ni exact, ni par préfixe, ni approximatif.
regionFacultatifChaîne de région facultative et non vide, comme US, transmise en tant que contexte géographique de recherche. Elle ne prouve pas où les publicités d’un annonceur ont été diffusées.

Comment utiliser la Google Ad Library Advertiser Search API

Envoyez un terme de recherche, suivez la tâche asynchrone, puis examinez chaque annonceur candidat normalisé avant d’utiliser son identité dans vos recherches suivantes.

  1. Choisissez un terme précis : annonceur, marque, organisation ou site web ; ajoutez au besoin une région comme US.
  2. Envoyez query et, en option, region en POST à /v1/google-ad-library/advertiser-search, puis conservez le task_id.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
  4. Lisez data.results.items et vérifiez l’identité du candidat avec plus qu’une ressemblance de nom avant de retenir un ID d’annonceur.
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

Cas d’usage de la Google Ad Library Advertiser Search API

  • Relier une marque à des ID d’annonceurs : Dressez une liste de candidats à partir d’un nom ou d’un site web avant de choisir l’ID d’annonceur pour une requête distincte d’inventaire des publicités publiques.
  • Séparer entités régionales et juridiques : Comparez noms, régions, sites web et pages publiques d’annonceurs lorsque plusieurs fiches voisines peuvent désigner des filiales, des revendeurs ou des organisations sans lien.
  • Constituer une file de vérification : Stockez les identités des candidats et les horodatages de collecte pour une vérification manuelle, sans conclure à une appartenance sur la seule ressemblance des noms.

Conseils d’expert pour la Google Ad Library Advertiser Search API

  • Utilisez une dénomination légale précise, une marque ou un terme proche d’un domaine ; une formulation large peut produire des candidats ambigus, et les règles de correspondance ne sont pas garanties.
  • Voyez dans region un contexte de recherche, et non la preuve que toutes les publicités de l’annonceur ont été diffusées dans cette zone.
  • Vérifiez les candidats avec l’ID, le nom, le site web, la région et leur page publique d’annonceur avant de fusionner des enregistrements ou de collecter des publicités.
  • N’envoyez pas results_limit : cette opération stocke le tableau d’annonceurs exploitables renvoyé par une seule réponse en amont et ne pagine pas la source.

En complément de la Google Ad Library Advertiser Search API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Google Ad Library.

  • Google Ad Library Ad API — Récupérez une création publique du Transparency Center à partir de son URL avec annonceur, texte, médias, diffusion, région, format, destination et impressions.
  • Google Ad Library Company Ads API — Collectez les créations publiques du Transparency Center par domaine d’entreprise ou ID d’annonceur avec contrôle du thème, de la région, de la date, de la surface, du format et du nombre de résultats.

Explorer d’autres plateformes

Combinez les données Google Ad Library avec les données publiques d’autres plateformes sociales prises en charge.

Google Ad Library Advertiser Search API — FAQ

Google Ad Library Advertiser Search API est une interface programmatique qui repère des annonceurs candidats du Google Ads Transparency Center à partir d’une requête et d’une région facultative. Elle renvoie l’identité normalisée de l’annonceur et, selon la source, le site web, le logo, la région et le nombre de publicités, mais pas les publicités elles-mêmes.

Elle renvoie uniquement des annonceurs candidats. Utilisez un ID d’annonceur vérifié ou un domaine avec l’opération distincte company-ads pour énumérer les publicités publiques.

La région est un contexte géographique transmis à la recherche d’annonceurs. Elle peut aider à restreindre les candidats, mais ce n’est ni un filtre exact garanti ni une preuve de la géographie de diffusion des publicités.

Non. Il s’agit du tableau complet d’annonceurs exploitables renvoyé par une seule réponse de recherche en amont au moment de la collecte, sans boucle de pagination SocQ ni limite contrôlée par l’appelant.

Chaque annonceur stocké coûte 0,5 crédit SocQ. L’estimation suppose 100 résultats et autorise un dépassement ; un résultat vide réussi n’entraîne que la base configurée à zéro crédit.