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ètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Terme 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. |
region | Facultatif | Chaî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.
- Choisissez un terme précis : annonceur, marque, organisation ou site web ; ajoutez au besoin une région comme US.
- Envoyez query et, en option, region en POST à /v1/google-ad-library/advertiser-search, puis conservez le task_id.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
- 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 candidatesCas 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.
API associées
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.