google-ad-library/
ad

Récupérez une publicité publique du Google Ads Transparency Center à partir de son URL exacte et obtenez, dans un enregistrement normalisé, l’identité de l’annonceur, le texte, les médias, les dates de diffusion, les régions, le format, la destination et les impressions disponibles.

Google Ad Library Ad API

URL exacte de la publicité
Annonceur et médias
Contexte public de diffusion
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 Ad

Les publicités du Google Ads Transparency Center sont des enregistrements publicitaires publics, avec l’identité de l’annonceur, le texte et les médias visibles, les liens de destination, les formats, les dates de diffusion, les régions et les données d’impressions disponibles. Ces informations servent à vérifier une création, à enrichir des publicités sélectionnées, à étudier le contexte de diffusion et à comparer des archives à un instant donné.

Fonctionnalités de la Google Ad Library Ad API

  • Résolution d’une publicité exacteTransforme une URL adstransparency.google.com contenant /creative/ en un enregistrement de publicité public normalisé, au plus, sans élargir la requête à une recherche.
  • Champs de l’annonceur et de la créationRenvoie l’identifiant de la création, l’URL source publique, le texte disponible, la référence de l’annonceur, la destination et le format dans un schéma de publicité stable.
  • Contexte de diffusionConserve les dates de début et de fin, les pays, les emplacements et une valeur scalaire d’impressions disponibles, uniquement lorsque les données sources peuvent être normalisées sans risque.
  • Médias normalisésExpose les références d’images ou de vidéos disponibles avec miniatures, dimensions et durée, et omet les valeurs facultatives absentes.

Paramètres de la Google Ad Library Ad API

ParamètresObligatoireDescription
urlObligatoireURL obligatoire d’une publicité publique du Google Ads Transparency Center. Le schéma doit être http ou https, l’hôte doit se terminer par adstransparency.google.com et le chemin doit contenir /creative/.

Comment utiliser la Google Ad Library Ad API

Envoyez l’URL exacte d’une publicité publique, suivez la tâche asynchrone, puis lisez l’enregistrement de publicité normalisé dans l’enveloppe de résultats standard.

  1. Préparez une URL http ou https sur adstransparency.google.com dont le chemin contient /creative/.
  2. Envoyez url en POST à /v1/google-ad-library/ad et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
  4. Lisez data.results.items ; l’opération de détail renvoie au plus un élément, de sorte que has_more vaut normalement false et next_cursor normalement null.
curl -X POST "https://api.socq.ai/v1/google-ad-library/ad" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR10449491775734153217"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; this detail operation returns at most one item

Cas d’usage de la Google Ad Library Ad API

  • Compléter une publicité sélectionnée : Utilisez l’ID de la création, la référence de l’annonceur, le texte, la destination, le format, les médias et l’URL source pour compléter un enregistrement de publicité déjà repéré.
  • Documenter la diffusion publique : Comparez dates, pays, emplacements et impressions disponibles pour établir où et quand une publicité connue a été observée publiquement.
  • Archiver des instantanés de publicités : Stockez le texte, les médias, l’annonceur, la diffusion, la destination et collected_at normalisés pour une comparaison ultérieure à un instant donné.

Conseils d’expert pour la Google Ad Library Ad API

  • Envoyez l’URL complète de la publicité plutôt qu’un identifiant CR seul ou l’URL d’un annonceur, pour que l’hôte et le chemin /creative/ passent la validation.
  • Distinguez une tâche en succès sans élément d’un échec du fournisseur : une publicité supprimée, restreinte ou indisponible peut ne donner aucun enregistrement exploitable.
  • Conservez les champs de diffusion, de texte, de destination, d’annonceur, d’impressions et de médias comme nullables au lieu de convertir des valeurs publiques manquantes en zéro ou en affirmations vides.
  • Passez par la recherche d’annonceurs et par les publicités d’une entreprise pour la découverte ou l’inventaire ; cette opération de détail ne résout volontairement que la publicité envoyée.

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

  • Google Ad Library Advertiser Search API — Repérez des annonceurs publics du Transparency Center par requête et région facultative avec identité, site web, logo, région et nombre de publicités disponible.
  • 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 Ad API — FAQ

Google Ad Library Ad API est une interface programmatique qui récupère une publicité publique du Google Ads Transparency Center à partir de son URL exacte. Elle renvoie l’annonceur, le texte, les médias, la diffusion, les régions, le format, la destination et les impressions disponibles, le tout normalisé.

Envoyez une seule URL http ou https dont l’hôte se termine par adstransparency.google.com et dont le chemin contient /creative/. Les ID de création seuls, les URL d’annonceurs, les domaines, les requêtes et les listes d’URL ne sont pas acceptés.

L’enregistrement normalisé déclare l’identité, l’URL source, le texte, l’annonceur, les dates de diffusion, les pays, les plateformes, le format, la destination, les impressions, les médias, la date de publication et la date de collecte. Les champs qui dépendent de la source restent nullables, et les médias peuvent être vides.

Une URL de publicité valide peut désigner un enregistrement public supprimé, restreint, mal formé ou momentanément indisponible. L’endpoint ne lui substitue pas une autre publicité et ne transforme pas la requête en recherche.

Chaque enregistrement renvoyé coûte 0,5 crédit SocQ. La politique de résultat vide configurée ne facture que la base à zéro crédit lorsqu’aucun enregistrement n’est renvoyé.