API annonceurs

Pilotez vos campagnes depuis vos outils

Une clé API liste les campagnes, crée des annonces et ouvre un lien de dépôt. La même clé connecte Claude, Cursor et ChatGPT.

Déposez 50 €, obtenez 100 €

Inscrivez-vous comme annonceur. Le premier dépôt de 50 € est abondé une fois. Comment fonctionne l'offre

Ce que vous pouvez faire

Lister les campagnes, les annonces, les stats du jour, le portefeuille et les transactions.
Créer et modifier des campagnes et des annonces.
Mettre une campagne en pause ou la relancer.
Créer une annonce à partir de l'URL d'une page.
Ouvrir un lien Stripe pour ajouter des fonds.

À savoir avant d'appeler l'API

Créez la clé dans Ads Manager, sous Paramètres, puis Clés API. Elle commence par idl_adv_.
read et write sont deux droits distincts. write n'inclut pas read. Chaque clé autorise 120 requêtes par minute.
Une nouvelle annonce reste en attente tant qu'une personne ne l'a pas modérée. Modifier le titre, le texte, le bouton, le lien ou l'image la remet en attente.
La première campagne créée via l'API ne peut pas être activée via l'API. L'erreur est first_campaign_requires_dashboard_validation et contient un lien vers cette campagne dans le tableau de bord.
Les montants sont en centimes d'euro.

Démarrage REST

Remplacez l'hôte par l'URL de votre projet Supabase. GET exige le droit read. POST et PATCH exigent le droit write.

curl 'https://<project-ref>.supabase.co/functions/v1/advertiser-api/campaigns' \
  -H 'Authorization: Bearer idl_adv_YOUR_KEY'

curl -X POST 'https://<project-ref>.supabase.co/functions/v1/advertiser-api/campaigns' \
  -H 'Authorization: Bearer idl_adv_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: campaign-2026-11-04' \
  -d '{
    "name": "Spring launch",
    "objective": "traffic",
    "budget_type": "daily",
    "budget_cents": 2000
  }'

Connecter Claude, Cursor ou ChatGPT

Le serveur MCP utilise la même clé, les mêmes droits et les mêmes 120 requêtes par minute. Envoyez la clé en Bearer.

Claude Desktop et Claude Code

{
  "mcpServers": {
    "idlen-advertiser": {
      "type": "http",
      "url": "https://<project-ref>.supabase.co/functions/v1/advertiser-mcp",
      "headers": {
        "Authorization": "Bearer idl_adv_YOUR_KEY"
      }
    }
  }
}

Cursor

{
  "mcpServers": {
    "idlen-advertiser": {
      "url": "https://<project-ref>.supabase.co/functions/v1/advertiser-mcp",
      "headers": {
        "Authorization": "Bearer idl_adv_YOUR_KEY"
      }
    }
  }
}

Collez ceci dans .cursor/mcp.json ou dans les réglages Cursor, puis MCP.

ChatGPT et les autres clients MCP distants

URL
https://<project-ref>.supabase.co/functions/v1/advertiser-mcp

Header
Authorization: Bearer idl_adv_YOUR_KEY

Utilisez cette URL et cet en-tête. Le client doit accepter application/json et text/event-stream.

OpenAPI

Les routes, les champs et les codes d'erreur sont dans le document OpenAPI.

advertiser-api.yaml