Retour aux API
Données indépendantes de transparence publicitaire publique

Google Ad Library API

Découvrez des annonceurs publics, collectez les créations d’une entreprise ou récupérez par URL une création connue du Transparency Center, pour la recherche et la vérification.

API Google Ad Library disponibles

Utilisez Advertiser Search pour trouver des candidats, Company Ads pour collecter des ensembles bornés de créations, et Ad Details pour résoudre l’URL exacte d’une création publique.

Quelles données de transparence publicitaire Google pouvez-vous récupérer ?

SocQ normalise les champs publics disponibles du Transparency Center et conserve les valeurs sources indisponibles à null ou vides.

Découverte d’annonceurs

Trouvez par requête des identités d’annonceurs candidates, sites web, logos, régions et champs de nombre de publicités disponibles.

Contexte des créations et des destinations

Collectez le texte, les références d’annonceurs, formats, ressources médias et pages de destination disponibles.

Contexte de diffusion public

Conservez les dates, pays, surfaces Google et valeurs d’impressions disponibles, normalisées sans risque.

SocQ et les produits Google Ads

SocQ normalise les enregistrements de transparence publics pris en charge. Les produits Google Ads restent le choix adapté pour les opérations autorisées sur les comptes et les campagnes.

FonctionnalitéSocQProduits Google Ads
Usage principalDécouvrir et normaliser des enregistrements de transparence publicsGérer des comptes publicitaires et des campagnes autorisés
EntréesRequête, identifiant d’entreprise et filtres, ou URL exacte d’une créationEntrées de compte, de campagne ou de reporting propres à chaque produit
AuthentificationClé API SocQIdentifiants et autorisations Google propres à chaque produit
Format de réponseEnregistrements normalisés d’annonceurs et de publicités publicsRéponse native propre à chaque produit

Fonctionnement des API Google Ad Library

Les trois endpoints suivent le cycle asynchrone de SocQ : envoi, interrogation, lecture des résultats.

  1. 1. Choisir un endpoint

    Envoyez une requête à Advertiser Search, un domaine ou un ID d’annonceur à Company Ads, ou l’URL d’une création à Ad Details.

  2. 2. Envoyer et suivre la tâche

    Envoyez la requête en POST, conservez task_id et interrogez /v1/tasks/{task_id} jusqu’à la fin du traitement.

  3. 3. Lire les résultats normalisés

    Traitez data.results.items ; Company Ads respecte le plafond demandé, tandis qu’Ad Details renvoie au plus un élément.

Collecter les publicités publiques d’une entreprise

Authentifiez-vous avec une clé API SocQ et indiquez soit le domaine d’une entreprise, soit un ID d’annonceur. Le plafond de résultats par défaut est de 40.

curl -X POST "https://api.socq.ai/v1/google-ad-library/company-ads" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"lululemon.com","results_limit":40}'

# Also available:
# POST /v1/google-ad-library/advertiser-search
# POST /v1/google-ad-library/ad
# Poll GET /v1/tasks/{task_id}

Cas d’usage courants de l’API Google Ad Library

Identification d’annonceurs

Résolvez une requête de marque ou de site en candidats d’annonceurs publics avant de collecter les publicités.

Veille des créations d’une entreprise

Collectez des ensembles bornés de créations publiques, avec des filtres facultatifs de sujet, région, date, surface et format.

Enrichissement de créations choisies

Complétez une création connue avec les champs d’annonceur, de texte, de médias, de destination et de diffusion.

Limites et politique sur les données publiques

Les résultats dépendent de la visibilité actuelle de la source publique et ne fournissent aucune donnée privée de compte Google Ads.

  • Advertiser Search exige une requête et accepte une région facultative ; il n’a pas d’entrée results_limit.
  • Company Ads exige domain ou advertiser_id et accepte results_limit par multiples de 40, de 40 à 2 000.
  • Ad Details exige une URL adstransparency.google.com dont le chemin contient /creative/ et renvoie au plus un élément.
  • Les enregistrements publics peuvent être incomplets et n’exposent ni budgets privés, ni clics, conversions, enchères, audiences, ni retour sur investissement publicitaire.

Questions fréquentes sur l’API Google Ad Library

Quel endpoint utiliser en premier ?

Utilisez Advertiser Search si vous ne connaissez qu’une marque ou un site web, Company Ads si vous avez un domaine ou un ID d’annonceur, et Ad Details si vous disposez déjà de l’URL exacte d’une création.

Puis-je filtrer les publicités d’une entreprise ?

Oui. Les contrôles facultatifs comprennent le sujet, la région, la période, la surface Google, le format et un results_limit borné.

Ces API peuvent-elles accéder aux performances privées des campagnes ?

Non. Elles travaillent sur des enregistrements de transparence publics et n’exposent aucune analyse privée de compte ou de campagne.

Comment les résultats sont-ils tarifés ?

Chaque enregistrement renvoyé coûte 0,5 crédit SocQ, sans frais de base configuré pour un résultat vide.

Réunissez dans un même workflow les profils publics, les contenus et les données d’engagement de différentes plateformes pour suivre des marques, des créateurs et des sujets, et mener plus efficacement une veille et des analyses multiplateformes.

Google Maps API

Découvrez des lieux publics, récupérez des détails normalisés à partir d’URL Maps connues et collectez des avis publics avec le contexte du lieu et de l’auteur relié à la source.

Amazon API

Recherchez des produits Amazon publics et collectez des détails de produits, Best Sellers, avis, profils de vendeurs et vitrines de créateurs normalisés sur les places de marché prises en charge.

Apple App Store API

Collectez les détails d’applications, les classements par catégorie et les avis publics de l’Apple App Store à partir d’URL connues de la boutique, sous forme d’enregistrements d’applications et d’avis normalisés.

SEO API

Interrogez en direct les résultats organiques de Google, comparez la demande et la difficulté de classement des mots-clés, développez des termes de départ, repérez les mots-clés et les pages qui assurent la visibilité d’un site dans la recherche, classez l’intention de recherche et collectez les résultats de Google News, Google Images, Google Autocomplete, Bing et YouTube. Chaque endpoint utilise la même clé API SocQ, le même flux de tâche asynchrone et le même format de résultat normalisé.

Telegram API

Lisez les chaînes Telegram publiques à partir de leurs liens t.me : profils de chaîne avec nombre d’abonnés, publications avec vues et réactions, publications isolées, commentaires des groupes de discussion, chaînes similaires et recherche dans tout l’historique.

Link in Bio API

Transformez l’unique lien de la bio Instagram, TikTok ou YouTube d’un créateur en données structurées : nom affiché, bio, avatar, e-mail de contact indiqué, profils sociaux liés et chaque bouton de la page avec son titre et sa destination.