En bref
L'API ChatGPT Ads, appelée Advertiser API par OpenAI, permet de créer et de gérer par programme les campagnes, groupes d'annonces, annonces, flux produits, conversions et rapports d'un compte Ads Manager. Elle s'adresse aux annonceurs et aux agences qui veulent automatiser des tâches répétitives, synchroniser leurs outils ou piloter de nombreuses campagnes sans tout faire à la main dans l'interface.
Mis à jour le 26 octobre 2026.
L'interface d'Ads Manager suffit pour lancer quelques campagnes. Dès que vous gérez plusieurs gammes de produits, plusieurs pays ou des promotions fréquentes, les manipulations répétitives deviennent une source d'erreurs. OpenAI a publié pour cela une documentation complète de son interface de programmation publicitaire, enrichie tout au long de 2026. Ce guide résume, à partir de la documentation développeur consultée le 26 octobre 2026, ce que l'API permet, comment elle est structurée et les règles de prudence à respecter. Si vous découvrez la plateforme, lisez d'abord notre guide sur le compte Ads Manager ChatGPT.
Advertiser API : l'interface de programmation d'OpenAI qui permet de créer et de gérer campagnes, groupes d'annonces, annonces, flux produits, suivi des conversions et rapports depuis votre propre application.
Clé API : l'identifiant secret qui authentifie vos requêtes ; il se crée dans la page Settings d'Ads Manager et doit être conservé sur un serveur, jamais dans du code visible.
Micros : l'unité utilisée par l'API pour les montants, un million de micros correspondant à une unité de la devise du compte.
Tâche groupée : une requête asynchrone qui regroupe de nombreuses créations ou modifications de campagnes, groupes d'annonces et annonces.
La documentation d'OpenAI indique que l'Advertiser API sert à créer et gérer des campagnes, des groupes d'annonces, des annonces, des flux produits, le suivi des conversions et les rapports, dans votre propre application ou pour automatiser des flux de travail (OpenAI Developers). Concrètement, voici des usages typiques pour un annonceur ou une agence :
Pour l'envoi des conversions, notre article sur le suivi des conversions ChatGPT Ads détaille le pixel et l'API de conversions, toujours dans le respect du consentement des visiteurs.
Il faut un compte publicitaire et une clé Advertiser API, que vous créez dans la page Settings d'Ads Manager. En France, l'accès en libre-service à Ads Manager est disponible, à condition que l'entité légale qui fait la publicité et qui est facturée soit basée dans un pays ouvert (OpenAI Help Center).
Toutes les requêtes passent par l'adresse de base api.ads.openai.com, avec la clé transmise dans l'en-tête Authorization. Sur les points de création compatibles, un en-tête Idempotency-Key évite de créer deux fois la même ressource si une requête est relancée après une coupure réseau (OpenAI Developers). Avant de créer quoi que ce soit, OpenAI conseille de récupérer le compte publicitaire pour vérifier la devise, le fuseau horaire, le statut et les examens en cours.
Une clé API donne le même pouvoir qu'un accès complet au compte publicitaire. Nous recommandons une clé par usage, stockée dans un gestionnaire de secrets, et un journal des modifications consulté régulièrement : la documentation d'OpenAI mentionne d'ailleurs des journaux d'audit pour retrouver les changements enregistrés dans le compte. Si un prestataire quitte le projet, révoquez sa clé le jour même.
La hiérarchie est la même que dans l'interface : un compte contient des campagnes, chaque campagne contient des groupes d'annonces, et chaque groupe contient des annonces. Chaque réglage se configure au niveau qui le possède.
| Niveau | Ce qui s'y configure |
|---|---|
| Compte publicitaire | Marque de l'annonceur, devise, fuseau horaire, accès, limites de dépenses |
| Campagne | Objectif, budget, calendrier, ciblage géographique et par plateforme, audiences, événements de conversion |
| Groupe d'annonces | Stratégie d'enchères, indications de contexte, multiplicateurs d'enchères par audience, ensemble de produits |
| Annonce | Création, image ou modèle produit, URL de destination |
Cette répartition, reprise de la documentation d'OpenAI (OpenAI Developers), explique pourquoi une erreur de budget se corrige au niveau de la campagne et une erreur d'enchère au niveau du groupe d'annonces. Les stratégies d'enchères sont détaillées dans notre article sur les enchères ChatGPT Ads.
L'exemple officiel crée une campagne, un groupe d'annonces et une annonce en pause, puis les active seulement une fois tout vérifié. Le parcours suit six étapes :
Pour les visuels, l'image doit mesurer au moins 640 x 640 pixels (OpenAI Developers). Pour le format de carte conversationnelle, le titre doit compter de 3 à 50 caractères, le texte 100 caractères au maximum et l'URL 2 048 caractères au maximum, avec une page accessible aux robots publicitaires d'OpenAI (OpenAI Developers). La documentation rappelle aussi qu'un aperçu montre l'apparence de l'annonce mais ne confirme pas qu'elle peut être diffusée. En cas de blocage, notre guide sur la campagne ChatGPT Ads sans impressions reprend toutes les vérifications.
Une tâche groupée peut contenir jusqu'à 1 000 opérations et un corps de requête de 16 Mio (OpenAI Developers). Elle accepte la création et la mise à jour de campagnes, de groupes d'annonces et d'annonces. Une option permet de valider les opérations sans les appliquer : c'est le mode que nous utilisons systématiquement avant tout changement en production.
Point capital : qu'une tâche continue ou s'arrête après une erreur, aucun mode n'annule les opérations déjà réussies. Une tâche mal préparée peut donc laisser un compte à moitié modifié. Il faut lire tous les résultats, opération par opération, avant de relancer quoi que ce soit.
L'API applique des limites par compte et par adresse IP : 600 requêtes par minute par point d'accès et 1 200 requêtes par minute au total, ainsi qu'une limite distincte de 10 requêtes toutes les 10 secondes pour la création de tâches groupées (OpenAI Developers).
Le journal des modifications de la documentation montre une API qui évolue vite. On y trouve notamment le ciblage géographique et la configuration des conversions le 3 juin 2026, les enchères optimisées pour les conversions le 16 juin 2026, les limites de dépenses quotidiennes au niveau du compte pour la facturation sur facture le 9 septembre 2026, le ciblage séparé des navigateurs ordinateur, iOS et Android le 10 septembre 2026, et des fenêtres d'attribution paramétrables le 30 septembre 2026, avec par défaut 30 jours après un clic et 1 jour après une vue (OpenAI Developers).
Autre échéance à noter : pour les flux produits, les comptes qui utilisent encore l'ancien ordre de priorité des paramètres de suivi doivent migrer avant le 5 novembre 2026 (OpenAI Developers). Si vous utilisez un flux, notre guide du flux produits ChatGPT Ads explique son fonctionnement. Enfin, la documentation du compte précise que modifier le nom légal ou le nom de marque public met la diffusion en pause jusqu'à ce que le compte soit de nouveau examiné (OpenAI Developers).
Dans la page Settings d'Ads Manager. La clé doit être stockée de façon sécurisée sur votre serveur. Source : OpenAI Developers.
Non. Créer une annonce la soumet à l'examen, et la diffusion ne démarre qu'après activation et lorsque toutes les autres conditions sont remplies. Source : OpenAI Developers.
Jusqu'à 1 000 opérations, pour un corps de requête de 16 Mio au maximum. Source : OpenAI Developers.
Non. Aucun mode n'annule les opérations déjà réussies : il faut lire les résultats et corriger les opérations en échec. Source : OpenAI Developers.
Oui. Modifier le nom légal ou le nom de marque public met la diffusion en pause jusqu'au nouvel examen du compte. Source : OpenAI Developers.
Nous aidons les annonceurs à structurer leurs comptes ChatGPT Ads avant d'automatiser, pour éviter qu'un script ne multiplie les erreurs. Découvrez notre offre ChatGPT Ads, notre page agence ChatGPT Ads en France, demandez un audit gratuit ou contactez-nous. Côté Google, l'équivalent hors ligne est Google Ads Editor.
Facturation ChatGPT Ads : post-paiement par carte, seuil de paiement, budgets quotidiens, autorisation bancaire, paiement refusé, TVA et factures.
Flux produits ChatGPT Ads : préparer le catalogue, importer le flux, créer une campagne Product feed, filtres, ads_metadata et onglet Products.
Rapports ChatGPT Ads : métriques d'Ads Manager, délais d'actualisation, conversions, fenêtres d'attribution, exports CSV et écarts avec Analytics.
Notre équipe vous offre un audit gratuit de vos campagnes.
Demander mon audit