Votre AI Growth Manager comprend le portefeuille, fixe une mission et demande des actions. AdsAutoma conserve la décision publicitaire spécialisée, les protections financières et l’unique accès à Google Ads.
Créez la clé depuis le menu Developer. La valeur complète n’est affichée qu’une seule fois.
curl "https://api.adsautoma.com/v1/projects?limit=25" \
-H "Authorization: Bearer aa_live_VOTRE_CLE" \
-H "Accept: application/json"Une réponse réussie utilise toujours l’enveloppe suivante :
{
"success": true,
"data": { "items": [] },
"meta": {
"request_id": "6df9…",
"api_version": "v1"
}
}Chaque clé dispose de permissions indépendantes. Ne placez jamais une clé aa_live_ dans une application mobile, un dépôt Git ou du JavaScript public. L’appel doit partir de votre serveur.
Collez une clé API, choisissez un endpoint dans la liste puis préparez l’appel. La clé reste uniquement dans la mémoire de cette page : elle n’est jamais enregistrée dans un cookie ou le stockage du navigateur.
Sélectionnez un endpoint puis envoyez la requête.Commencez par GET /v1/capabilities : l’agent découvre uniquement les opérations autorisées par sa clé. Il peut ensuite suivre cette boucle courte et stable :
/v1/portfolio-summary pour choisir le projet prioritaire./v1/projects/{id}/executive-summary, puis les alertes et recommandations.POST /v1/projects/{id}/goal.dry_run: true.Idempotency-Key unique./decisions pour comprendre l’acceptation ou le refus d’AdsAutoma.Ouvrez un endpoint puis cliquez sur Préparer le test. Les identifiants comme {id} devront être remplacés par ceux retournés par votre compte.
/v1Informations générales sur l’API.⌄Informations générales sur l’API.
public/v1/healthVérifier que l’API et sa base de données répondent.⌄Vérifier que l’API et sa base de données répondent.
public/v1/openapi.jsonRécupérer le contrat OpenAPI 3.1 complet.⌄Récupérer le contrat OpenAPI 3.1 complet.
public/v1/accountProfil, langue et abonnement du compte.⌄Profil, langue et abonnement du compte.
account:read/v1/accountModifier le nom et la langue du compte.⌄Modifier le nom et la langue du compte.
account:write/v1/integrations/google-adsÉtat de la connexion Google Ads et dernière synchronisation.⌄État de la connexion Google Ads et dernière synchronisation.
account:read/v1/integrations/google-adsDéconnecter et révoquer les jetons Google Ads enregistrés.⌄Déconnecter et révoquer les jetons Google Ads enregistrés.
account:write/v1/capabilitiesDécouvrir les actions que la clé courante est autorisée à demander.⌄Découvrir les actions que la clé courante est autorisée à demander.
account:read/v1/portfolio-summaryComparer tous les projets dans une synthèse compacte.⌄Comparer tous les projets dans une synthèse compacte.
reports:read/v1/projects/{id}/executive-summaryComprendre immédiatement résultats, tendance, risques et recommandations.⌄Comprendre immédiatement résultats, tendance, risques et recommandations.
projects:read/v1/projects/{id}/performanceComparer les performances par jour ou par campagne.⌄Comparer les performances par jour ou par campagne.
projects:read/v1/projects/{id}/goalDonner une mission chiffrée avec budget, durée et risque maximal.⌄Donner une mission chiffrée avec budget, durée et risque maximal.
projects:write/v1/projects/{id}/budget-statusLire consommation, projection, limites et protection financière.⌄Lire consommation, projection, limites et protection financière.
projects:read/v1/projects/{id}/recommendationsLire les recommandations du moteur AdsAutoma.⌄Lire les recommandations du moteur AdsAutoma.
actions:read/v1/projects/{id}/optimizeDemander à AdsAutoma une nouvelle analyse professionnelle.⌄Demander à AdsAutoma une nouvelle analyse professionnelle.
actions:write/v1/projects/{id}/decisionsExpliquer chaque décision avec état avant/après et preuves.⌄Expliquer chaque décision avec état avant/après et preuves.
actions:read/v1/projects/{id}/activityLire la chronologie opérationnelle du projet.⌄Lire la chronologie opérationnelle du projet.
activity:read/v1/projects/{id}/alertsRécupérer les anomalies et l’action conseillée.⌄Récupérer les anomalies et l’action conseillée.
notifications:read/v1/projects/{id}/emergency-stopSuspendre immédiatement toutes les dépenses du projet.⌄Suspendre immédiatement toutes les dépenses du projet.
campaigns:write/v1/projects/{id}/emergency-resumeReprendre uniquement si les protections l’autorisent.⌄Reprendre uniquement si les protections l’autorisent.
campaigns:write/v1/projectsLister les projets avec connexion Google, tracking, budget et dépense du mois.⌄Lister les projets avec connexion Google, tracking, budget et dépense du mois.
projects:read/v1/projectsCréer un projet et recevoir sa clé de tracking une seule fois.⌄Créer un projet et recevoir sa clé de tracking une seule fois.
projects:write/v1/projects/{id}Consulter l’offre, l’objectif, les contraintes, campagnes et anomalies.⌄Consulter l’offre, l’objectif, les contraintes, campagnes et anomalies.
projects:read/v1/projects/{id}Modifier l’offre, les pays et les limites financières.⌄Modifier l’offre, les pays et les limites financières.
projects:write/v1/projects/{id}Archiver le projet dans AdsAutoma.⌄Archiver le projet dans AdsAutoma.
projects:write/v1/projects/{id}/pauseSuspendre et auditer les campagnes du projet.⌄Suspendre et auditer les campagnes du projet.
projects:write/v1/projects/{id}/resumeRéactiver le projet si le tracking et le budget sont fiables.⌄Réactiver le projet si le tracking et le budget sont fiables.
projects:write/v1/projects/{id}/campaignsLister les campagnes du projet avec santé et rentabilité.⌄Lister les campagnes du projet avec santé et rentabilité.
campaigns:read/v1/projects/{id}/automationLire le mode autonome et toutes ses règles de sécurité.⌄Lire le mode autonome et toutes ses règles de sécurité.
projects:read/v1/projects/{id}/automationRégler le niveau d’autonomie et la hausse maximale de budget.⌄Régler le niveau d’autonomie et la hausse maximale de budget.
projects:write/v1/projects/{id}/tracking-keyRenouveler la clé serveur de tracking.⌄Renouveler la clé serveur de tracking.
tracking:write/v1/analysesAnalyser une URL et générer le plan complet par IA.⌄Analyser une URL et générer le plan complet par IA.
projects:write/v1/analyses/{token}Relire le plan, les mots-clés et les annonces proposés.⌄Relire le plan, les mots-clés et les annonces proposés.
projects:read/v1/analyses/{token}/publishCréer les campagnes dans le compte Google Ads connecté, en pause et protégées.⌄Créer les campagnes dans le compte Google Ads connecté, en pause et protégées.
campaigns:write/v1/campaignsLister les campagnes et leurs KPI sur 30 jours.⌄Lister les campagnes et leurs KPI sur 30 jours.
campaigns:read/v1/campaigns/syncSynchroniser Google Ads, métriques, mots-clés, annonces et recherches.⌄Synchroniser Google Ads, métriques, mots-clés, annonces et recherches.
campaigns:write/v1/campaigns/{id}Détail utile d’une campagne, sans données Google brutes inutiles.⌄Détail utile d’une campagne, sans données Google brutes inutiles.
campaigns:read/v1/campaigns/{id}/pauseSuspendre la campagne via le moteur AdsAutoma et journaliser la raison.⌄Suspendre la campagne via le moteur AdsAutoma et journaliser la raison.
campaigns:write/v1/campaigns/{id}/resumeRéactiver après validation de l’abonnement, du tracking et des limites.⌄Réactiver après validation de l’abonnement, du tracking et des limites.
campaigns:write/v1/campaigns/{id}/budgetPrévisualiser ou appliquer un budget avec tous les garde-fous.⌄Prévisualiser ou appliquer un budget avec tous les garde-fous.
campaigns:write/v1/campaigns/{id}/budgetMéthode compatible pour la même modification sécurisée.⌄Méthode compatible pour la même modification sécurisée.
campaigns:write/v1/campaigns/{id}/keywordsLister mots-clés, correspondances, coût et conversions.⌄Lister mots-clés, correspondances, coût et conversions.
campaigns:read/v1/campaigns/{id}/adsLister annonces, contenus et validation Google.⌄Lister annonces, contenus et validation Google.
campaigns:read/v1/campaigns/{id}/search-termsLister les recherches réelles des internautes.⌄Lister les recherches réelles des internautes.
campaigns:read/v1/campaigns/{id}/reviewsConsulter les audits avant, pendant et après diffusion.⌄Consulter les audits avant, pendant et après diffusion.
campaigns:read/v1/projects/{id}/tracking-statusVérifier fraîcheur, problèmes et droit actuel d’optimiser.⌄Vérifier fraîcheur, problèmes et droit actuel d’optimiser.
tracking:read/v1/projects/{id}/conversionsFiltrer les conversions par période, campagne et type.⌄Filtrer les conversions par période, campagne et type.
tracking:read/v1/projects/{id}/eventsLister les événements de conversion reçus.⌄Lister les événements de conversion reçus.
tracking:read/v1/projects/{id}/eventsEnvoyer une inscription, vente, paiement ou renouvellement côté serveur.⌄Envoyer une inscription, vente, paiement ou renouvellement côté serveur.
tracking:write/v1/ai/askQuestionner le gestionnaire IA avec les données réelles du portefeuille.⌄Questionner le gestionnaire IA avec les données réelles du portefeuille.
ai:use/v1/actionsLister les décisions proposées ou exécutées.⌄Lister les décisions proposées ou exécutées.
actions:read/v1/actions/{id}/approveApprouver et exécuter une décision après les contrôles financiers.⌄Approuver et exécuter une décision après les contrôles financiers.
actions:write/v1/actions/{id}/rejectRefuser une proposition.⌄Refuser une proposition.
actions:write/v1/reports/summaryRapport détaillé sur 7, 30 ou 90 jours.⌄Rapport détaillé sur 7, 30 ou 90 jours.
reports:read/v1/notificationsLister les alertes du compte.⌄Lister les alertes du compte.
notifications:read/v1/notifications/{id}Marquer une alerte comme lue.⌄Marquer une alerte comme lue.
notifications:write/v1/billingAbonnement et solde des crédits IA.⌄Abonnement et solde des crédits IA.
billing:read/v1/billing/plansLister les abonnements et montants de recharge disponibles.⌄Lister les abonnements et montants de recharge disponibles.
billing:read/v1/billing/checkout/subscriptionCréer un paiement Stripe manuel pour renouveler l’abonnement.⌄Créer un paiement Stripe manuel pour renouveler l’abonnement.
billing:write/v1/billing/checkout/topupCréer un paiement Stripe pour recharger les crédits IA.⌄Créer un paiement Stripe pour recharger les crédits IA.
billing:write/v1/usageConsommation IA, tokens et montant débité.⌄Consommation IA, tokens et montant débité.
billing:read/v1/activityHistorique des opérations du compte.⌄Historique des opérations du compte.
activity:readLe mode simulation exécute les mêmes contrôles que l’application réelle, sans modifier AdsAutoma ni Google Ads.
POST /v1/campaigns/87/budget
Idempotency-Key: preview-budget-87-20260901
{
"daily_budget": 45,
"reason": "CPA inférieur à l’objectif avec 12 conversions fiables",
"dry_run": true
}La réponse contient allowed, blocked, la première raison de refus, maximum_allowed_now et le détail de chaque contrôle : abonnement, plafonds, tracking, hausse maximale, délai de stabilité et volume d’apprentissage.
L’analyse consomme des crédits IA et produit un plan modifiable valable deux heures.
POST /v1/analyses
Idempotency-Key: analyse-produit-2026-09-01
{
"url": "https://example.com/produit"
}Après validation du plan, publiez-le avec vos limites financières :
POST /v1/analyses/{analysis_token}/publish
Idempotency-Key: publication-produit-2026-09-01
{
"monthly_budget": 600,
"target_cpa": 20,
"objective": "sale",
"countries": ["BE", "FR"],
"autonomy_mode": "automatic"
}POST /v1/projects/42/events
Idempotency-Key: order-ORDER-456
{
"event": "subscription_paid",
"event_id": "order-ORDER-456",
"user_id": "USER-123",
"order_id": "ORDER-456",
"value": 49.00,
"currency": "EUR",
"consent": true,
"occurred_at": "2026-09-01T14:30:00+02:00"
}Réutiliser le même event_id ne crée pas de doublon. Les identifiants gclid, gbraid et wbraid peuvent aussi être transmis.
L’API crée une session Stripe Checkout puis retourne son URL. Le paiement reste ponctuel : aucune souscription récurrente n’est créée chez Stripe.
POST /v1/billing/checkout/topup
Idempotency-Key: topup-25-commande-123
{
"amount": 25
}data.url.Le webhook Stripe vérifie ensuite le montant, la devise, le propriétaire et crédite le portefeuille une seule fois.?page=1&limit=25, avec une limite maximale de 100.Idempotency-Key aux créations et appels IA sensibles. La réponse est conservée 24 heures et liée à la méthode, au chemin et au corps exacts.X-RateLimit-Limit et X-RateLimit-Remaining.X-Request-Id et meta.request_id.{
"success": false,
"error": {
"code": "insufficient_scope",
"message": "This API key does not have the required permission.",
"details": { "required_scope": "campaigns:write" }
},
"request_id": "95a7…"
}L’API ne contourne jamais les règles financières. Une hausse de budget est refusée si le tracking est défaillant, si le plafond mensuel serait dépassé, si le volume d’apprentissage est insuffisant ou si l’abonnement n’est plus actif. Chaque ressource est vérifiée contre le propriétaire de la clé.