API ChatGPT Ads : tout ce qu'elle sait faire, et ce qu'on en fait
Paid
De :
Sacha Reusa
Dernière mise à jour :
9/9/2026
L'API ChatGPT Ads (l'Advertiser API d'OpenAI) permet de créer et de piloter des campagnes, des groupes d'annonces et des annonces par programme, d'extraire le reporting à chaque niveau du compte et de remonter les conversions côté serveur. Elle répond sur api.ads.openai.com/v1, avec une clé générée dans les paramètres de l'Ads Manager. Chez 1144, notre dashboard la consomme tous les jours depuis le 4 septembre 2026. Voici ce qu'elle sait faire, endpoint par endpoint, et les pièges qu'on a payés en la branchant. Mis à jour le 9 octobre 2026.
Qu'est-ce que l'API ChatGPT Ads, exactement ?
L'API ChatGPT Ads regroupe en réalité deux familles d'outils que beaucoup confondent.
→ L'Advertiser API sert à piloter le compte : créer, modifier, activer, mettre en pause et archiver les objets, lire les performances, consulter l'historique des modifications. C'est l'équivalent de l'API Google Ads ou de l'API Marketing de Meta.
→ La Conversions API sert à envoyer de la donnée à OpenAI : vos conversions, depuis votre serveur, en complément du pixel.
Les deux sont documentées publiquement sur developers.openai.com/ads. La documentation existe aussi en Markdown (ajoutez .md à l'URL d'une page), ce qui la rend lisible par vos outils et vos agents.
Pour le fonctionnement général du canal (formats, coûts, ciblage), tout est dans notre guide ChatGPT Ads.
Comment obtenir une clé API ChatGPT Ads
La clé se crée dans l'Ads Manager, onglet Settings. Trois choses à savoir avant de la générer.
→ Une clé égale un compte publicitaire. La documentation le dit noir sur blanc : chaque clé est rattachée à un seul compte. Une agence qui gère plusieurs annonceurs gère donc une clé par client.
→ L'authentification est un jeton porteur (en-tête Authorization: Bearer). La clé reste côté serveur, jamais dans un navigateur.
→ Le test le plus simple est un appel à GET /ad_account. S'il répond avec la devise et le fuseau horaire du compte, la clé fonctionne.
Conséquence pratique de la première règle : la réponse de l'API ne porte pas le nom du compte, puisque la clé ne voit que lui. Si vous agrégez plusieurs comptes dans un même outil, c'est à vous de nommer chaque flux. Nous le figeons dans la configuration plutôt que de le relire à chaque appel : un renommage dans l'Ads Manager ne doit pas casser le rattachement compte vers client.
Gérer campagnes, groupes d'annonces et annonces par API
La hiérarchie est celle de l'Ads Manager, et chaque réglage vit au niveau qui le porte.
→ Le compte : marque, devise, fuseau horaire, plafonds de dépense. → La campagne : type d'enchère, budget, calendrier, ciblage géographique et plateformes. → Le groupe d'annonces : enchère maximale, indices contextuels, multiplicateurs d'audience, ensemble de produits. → L'annonce : le texte, l'image et l'URL de destination.
Les trois objets partagent les mêmes verbes : GET pour lister ou lire, POST pour créer, POST /{id} pour modifier, puis /activate, /pause et /archive. Deux détails qui surprennent : la mise à jour passe par un POST (pas de PATCH), et il n'existe aucune suppression. L'archivage est le seul moyen de sortir un objet, et il est irréversible.
Ce qu'on règle sur une campagne
L'optimisation se choisit avec bidding_type (impressions, clics ou conversions). Le budget documenté est un budget total, budget.lifetime_spend_limit_micros, exprimé en micros. Les dates de début et de fin passent en timestamps UNIX, et le ciblage se pose dans targeting.locations et targeting.platforms.
Ce qu'on règle sur un groupe d'annonces
L'enchère maximale (bidding_config.max_bid_micros) et l'événement facturé, impression ou clic. Et surtout context_hints, un tableau de textes libres : ce sont les indices contextuels, le seul vrai levier de ciblage du canal, désormais pilotables par programme. Les multiplicateurs d'audience personnalisée vont de 0,1 à 10.
Ce qu'on règle sur une annonce
Une annonce chat_card demande un titre (3 à 50 caractères), un texte (100 caractères maximum), une URL de destination et un file_id, l'identifiant d'une image envoyée au préalable via l'endpoint d'upload. Une annonce product_ad_template prend son image dans votre flux produit. Et POST /ads/{id}/preview génère un aperçu valable 24 heures, pratique pour faire valider une annonce sans ouvrir la console.
Le reporting par API : ce que l'endpoint Insights renvoie
Quatre portes d'entrée, une par niveau : /ad_account/insights, /campaigns/{id}/insights, /ad_groups/{id}/insights et /ads/{id}/insights. Chacune accepte son propre niveau d'agrégation et ceux du dessous.
→ Granularité : sans découpage, par jour ou par mois. → Segments : produit, pays, appareil ou plateforme. Un seul par requête. → Pagination : limit de 1 à 2 000 lignes (20 par défaut), puis curseurs after et before. → Fenêtre : bornes en secondes UNIX.
Les conversions ont leur propre endpoint, POST /conversions/insights, qui fonctionne différemment : pas de curseur, pas de paramètre limit, et un plafond de 2 000 lignes. Au-delà, l'API renvoie une erreur 413 au lieu d'un résultat partiel. Il faut alors découper la période ou réduire le nombre d'entités.
Ce que le reporting ne fera pas, en revanche : aucun rapport de termes de recherche, puisque le canal n'a pas de mots-clés. Vous ne saurez jamais par API dans quelles conversations vos annonces sont apparues, pas plus que dans la console.
Ce qu'on a appris en branchant l'API sur notre dashboard
Windsor, qui alimente nos tableaux de bord pour Google Ads, Meta Ads et LinkedIn Ads, n'avait pas de connecteur OpenAI au moment où on a voulu suivre ChatGPT Ads. On a donc branché l'API en direct. Chaque matin, le dashboard 1144 récupère la dépense, les impressions et les clics par jour, au niveau de la campagne, du groupe d'annonces, de l'annonce et de l'appareil, puis les conversions. Quatre choses que la documentation ne dit pas clairement, et qui produisent toutes un chiffre faux sans aucun message d'erreur :
→ Les journées commencent à minuit dans le fuseau du compte, pas à minuit UTC. Avec des bornes en UTC, chaque ligne était datée d'un jour trop tôt : la dépense d'hier comptée avant-hier. Le fuseau se lit dans GET /ad_account.
→ Les identifiants de campagne se demandent. Sans campaign.id et campaign.name dans les champs demandés, la réponse ne les porte pas, même agrégée par campagne. L'identifiant de l'entité reste lisible dans la clé de chaque ligne, mais il faut aller le chercher.
→ Les lignes de groupe et d'annonce ne disent pas à quelle campagne elles appartiennent. Le rattachement se reconstruit avec GET /ad_groups et GET /ads, un appel par collecte.
→ L'endpoint des conversions refuse le paramètre limit. Le 9 octobre 2026, notre synchronisation est tombée sur une erreur 400 « Unknown parameter: 'limit' ». Le paramètre est valide sur les insights de diffusion, pas sur celui des conversions. Corrigé dans la journée.
Dernier réflexe : ne stockez jamais un CTR, un CPC ou un CPM renvoyé par l'API. Additionner deux ratios ne veut rien dire. Stockez impressions, clics et dépense, et recalculez.
Les paramètres d'URL : le lien entre l'API et votre CRM
Ajouter des paramètres à des annonces ChatGPT Ads
Le reporting par API vous dit ce qui a été dépensé. Les paramètres d'URL vous disent ce que ce trafic est devenu chez vous.
Au niveau du groupe d'annonces, le champ des paramètres de requête ajoute automatiquement des valeurs à vos URL : {campaign_id}, {ad_group_id}, {ad_id}, {ad_account_id} et {oppref}. Ce sont les mêmes identifiants que ceux de l'API. C'est ce qui permet de joindre une ligne de dépense à un lead dans votre CRM, au niveau de l'annonce.
Combinez-les avec votre plan UTM : les identifiants donnent la granularité technique, les UTM donnent la lecture métier.
La Conversions API, l'autre moitié du dispositif
La Conversions API envoie vos conversions depuis votre serveur, avec l'identifiant oppref ajouté à l'URL au moment du clic. La configuration recommandée est le double envoi : le pixel côté navigateur et l'API côté serveur, avec le même identifiant d'événement pour dédupliquer.
Elle devient indispensable dès que votre conversion se produit hors du navigateur : un lead qualifié par un commercial, un abonnement confirmé après paiement. Sur un cycle B2B long, c'est la seule façon de remonter une conversion qui compte. Le dispositif complet, pixel et consentement compris, est détaillé dans notre article sur la mesure des conversions ChatGPT Ads.
Quotas, traitement en masse et journal d'audit
→ 600 requêtes par minute et par endpoint, 1 200 par minute au total. Les deux limites s'appliquent par compte publicitaire et par adresse IP. → La Bulk API (POST /bulk_mutation_jobs) crée ou modifie jusqu'à 1 000 objets en un seul job asynchrone, avec un mode de validation à blanc. Elle est en préversion limitée et s'active compte par compte : un 404 veut dire qu'elle n'est pas ouverte sur le vôtre. Son quota est à part, 10 requêtes par tranche de 10 secondes. → Le journal d'audit (GET /audit_logs) rend l'historique des modifications du compte, avant et après, filtrable par campagne, groupe, annonce et auteur. Utile dès que plusieurs personnes ou plusieurs outils touchent au même compte.
Pour un annonceur qui démarre avec quelques campagnes, ces quotas ne se font jamais sentir. Notre dashboard tient dans quelques dizaines d'appels par passage.
Brancher l'API en 6 étapes
Générez la clé dans l'onglet Settings de l'Ads Manager, une par compte, et stockez-la côté serveur.
Testez-la avec GET /ad_account et relevez le fuseau horaire du compte.
Posez vos bornes de date à minuit dans ce fuseau, en secondes UNIX, la borne haute au lendemain du dernier jour voulu.
Demandez explicitement les identifiants et les noms dans les champs, à chaque niveau d'agrégation.
Rattachez groupes et annonces à leur campagne via GET /ad_groups et GET /ads.
Branchez les conversions séparément, sans paramètre limit, et découpez la période si vous approchez des 2 000 lignes.
Ce que fait 1144 avec l'API ChatGPT Ads
Notre campagne ChatGPT Ads était en ligne le jour de l'ouverture française. Trois jours plus tard, ses chiffres arrivaient dans le même dashboard que Google Ads, Meta Ads et LinkedIn Ads, avec les mêmes règles de conversion et le même contrôle des totaux. ChatGPT Ads y est un quatrième levier comme les autres, comparable au jour près.
Aujourd'hui, on utilise l'API en lecture : diffusion, coûts, conversions, rattachement des objets. La création et la modification par API sont documentées et disponibles. C'est la prochaine marche : déployer des groupes d'annonces et leurs indices contextuels depuis nos propres outils.
On a rien inventé. On a juste branché le canal sur le système qui pilote déjà tout le reste.
Questions fréquentes sur l'API ChatGPT Ads
Existe-t-il une API ChatGPT Ads ?
Oui. OpenAI documente une Advertiser API complète sur developers.openai.com/ads : gestion des campagnes, des groupes d'annonces et des annonces, reporting, fichiers, journal d'audit et configuration des conversions. Elle répond sur api.ads.openai.com/v1. La Conversions API, qui envoie vos conversions côté serveur, vient en complément.
Comment obtenir une clé API ChatGPT Ads ?
Dans l'Ads Manager, onglet Settings. La clé est rattachée à un seul compte publicitaire et s'utilise en jeton porteur dans l'en-tête Authorization. Testez-la avec un appel à GET /ad_account : s'il renvoie la devise et le fuseau horaire du compte, elle fonctionne. Gardez-la côté serveur.
Peut-on créer des campagnes ChatGPT Ads par API ?
Oui. Campagnes, groupes d'annonces et annonces se créent, se modifient, s'activent, se mettent en pause et s'archivent par API. Il n'existe pas de suppression : l'archivage est définitif. Pour des volumes importants, la Bulk API traite jusqu'à 1 000 opérations par job, mais elle est en préversion limitée et s'active compte par compte.
Peut-on récupérer le reporting ChatGPT Ads par API ?
Oui, via l'endpoint Insights, au niveau du compte, de la campagne, du groupe d'annonces ou de l'annonce, par jour ou par mois, avec un segment au choix parmi produit, pays, appareil ou plateforme. Les conversions passent par un endpoint séparé, POST /conversions/insights, plafonné à 2 000 lignes et sans pagination.
Quelles sont les limites de l'API ChatGPT Ads ?
600 requêtes par minute et par endpoint, 1 200 au total, par compte et par adresse IP. La Bulk API a son propre quota de 10 requêtes par tranche de 10 secondes. Côté données, aucun rapport de termes de recherche n'existe, puisque le canal fonctionne sans mots-clés.
Quelle différence entre l'Advertiser API et la Conversions API ?
L'Advertiser API pilote le compte et lit ses performances. La Conversions API envoie des événements de conversion depuis votre serveur vers OpenAI, en double envoi avec le pixel et un identifiant d'événement commun pour dédupliquer. La première vous sert à gérer, la seconde à mesurer.
Et après ?
L'API ChatGPT Ads est déjà plus complète que ce que la plupart des articles en disent : gestion, reporting, conversions, audit, traitement en masse. Le vrai travail est ailleurs, dans les détails qui faussent un chiffre sans prévenir : le fuseau, les identifiants, le rattachement des objets. Branchez-la proprement une fois, et le canal se pilote comme les autres.
Quality Score Google Ads : la note que tout le monde regarde et que personne ne pilote
Quality Score Google Ads : ce que mesure la note de 1 à 10, pourquoi elle n'entre pas dans l'enchère, et les 5 étapes qui font vraiment baisser vos CPC.
API ChatGPT Ads : tout ce qu'elle sait faire, et ce qu'on en fait
API ChatGPT Ads : créer et piloter campagnes et annonces, extraire le reporting, remonter les conversions. Endpoints, quotas et pièges testés sur notre compte.
Conversions ChatGPT Ads : câbler la mesure avant le premier euro
Pixel OpenAI, Conversions API, paramètres d'URL et le prérequis silencieux qui bloque la diffusion : l'ordre de câblage testé sur notre propre compte français.
ChatGPT Ads Manager : ce qu'on voit vraiment dans la console
OpenAI Ads Manager en français, écran par écran : création du compte, les 3 réglages définitifs, campagne, annonce et reporting. Testé sur notre propre compte.
Prospection multicanal : quatre points de contact valent cinq fois un seul
Prospection multicanal : le taux de réponse double face à l'email seul. Nos chiffres sur un an de prospection commerciale B2B, et les 3 réglages qui comptent.
Remarketing Google Ads en B2B : votre audience est déjà assez grande
Remarketing Google Ads en B2B : le seuil minimum est passé à 100 visiteurs actifs sur 30 jours. Ce que ça change, et les réglages qui brûlent du budget.
Stratégie, rédaction et maintenant analyse... comment on optimise nos comptes chez 1144
Chez 1144, ça fait maintenant des mois qu’on teste l’IA sur à peu près tout ce qu’on fait en paid : génération de visuels publicitaires, rédaction des messages publicitaires, mise en ligne automatisée des campagnes, challenge de la stratégie avant un rendez-vous client.
Enrichissement data B2B : les outils qui changent votre pipeline
30% de vos données B2B sont mortes en un an. Clay, Pipecorn, Pharow, Icypeas, Dropcontact : les outils qui gardent un pipeline B2B propre et exploitable.
Nurturing automatisé : transformer vos leads froids en clients
80% des leads B2B ne convertissent jamais. Le nurturing automatisé change ça : scoring, séquences, timing. La méthode 1144 pour des leads prêts à signer.
Cold email B2B en 2026 : tout le monde envoie plus. Ceux qui performent envoient moins.
Taux de réponse en chute, filtres IA, DMARC obligatoire. Le cold email B2B a muté en 2026. Voici ce qui marche encore. Et ce qu'on fait différemment chez 1144.
Product-Led Growth ou Sales ? Choisir, c’est se planter.
T’sais, le rêve : t’as un produit qui tue, tu lances une version freemium, et d’un coup, les users débarquent par centaines. Car oui, t’as bossé 1 journée sur un auto-onboarding.
Tes relances sont chiantes. Voici comment les rendre irrésistibles.
Aujourd’hui on va parler optimisation de messages dans ta séquence d’outbound. Et plus particulièrement des relances.T’as passé des heures à bosser ton ICP.Ton premier message est sharp.Tu lances ta séquence sur lemlist……et là, silence radio.
On parle acquisition entre nous depuis +2 ans. On a fini par appuyer sur REC 📹
Avec Damien, on passe nos journées à débattre Meta Ads, Google Ads et automatisation. On s'est dit : autant allumer une caméra. Ça donne Paid Off, un format vidéo sans script et sans filtre sur l'acquisition payante. On vous explique pourquoi et ce qu'on y raconte.
LinkedIn Ads : pourquoi sponsoriser un post de dirigeant/employés peut tout changer dans votre stratégie.
Les Thought Leader Ads LinkedIn annoncent 2,3x de CTR. La réalité est plus nuancée. Prérequis, métriques à regarder, objectifs : ce qu'on a testé chez 1144.
Quality Score Google Ads : la note que tout le monde regarde et que personne ne pilote
Quality Score Google Ads : ce que mesure la note de 1 à 10, pourquoi elle n'entre pas dans l'enchère, et les 5 étapes qui font vraiment baisser vos CPC.
API ChatGPT Ads : tout ce qu'elle sait faire, et ce qu'on en fait
API ChatGPT Ads : créer et piloter campagnes et annonces, extraire le reporting, remonter les conversions. Endpoints, quotas et pièges testés sur notre compte.
Conversions ChatGPT Ads : câbler la mesure avant le premier euro
Pixel OpenAI, Conversions API, paramètres d'URL et le prérequis silencieux qui bloque la diffusion : l'ordre de câblage testé sur notre propre compte français.
