Premiers pas avec l'API

L'API Gloriads permet à vos propres outils – un tableur, un script, une automatisation – de lire votre compte.

Elle est en lecture seule. Une clé lit votre compte et ne modifie rien. L'API est incluse dans toutes les formules et pendant l'essai gratuit.

Pour interroger un assistant IA sur votre compte, aucune clé n'est nécessaire : voir Connecter un assistant IA.

1. Créer une clé

Paramètres → API → Créer une clé. Donnez-lui le nom de l'outil qui va l'utiliser, puis copiez la clé. Elle commence par key_live_ et ne s'affiche qu'une seule fois.

Combien de clés vous pouvez avoir et comment en révoquer une : Authentification et clés API.

2. Faire votre premier appel

Chaque requête est envoyée à https://gloriads.com/api/v1 et porte votre clé dans l'en-tête Authorization :

curl https://gloriads.com/api/v1/account \
  -H "Authorization: Bearer YOUR_API_KEY"

/account prouve que la clé fonctionne, décrit le compte auquel elle appartient et indique jusqu'à quel jour vont vos chiffres Amazon Ads :

{
  "is_demo": false,
  "subscription": { "status": "active" },
  "api_key": {
    "name": "My script",
    "start": "key_live_ab12",
    "scopes": ["read"],
    "created_at": "2026-09-15T07:55:00.000Z",
    "last_used_at": null
  },
  "connected_app": null,
  "amazon_ads": {
    "connection": "connected",
    "marketplaces": 3,
    "performance_data": {
      "currency": "USD",
      "first_date": "2021-03-01",
      "last_date": "2026-10-09",
      "synced_at": "2026-10-10T06:12:00.000Z",
      "is_syncing": false,
      "history_complete": true
    }
  }
}

Si connection vaut error, reconnectez Amazon Ads dans Paramètres → Amazon Ads : sans cela, vos chiffres ne sont plus mis à jour.

3. Explorer tous les endpoints

Vos performances comparées à une période antérieure, vos produits, vos campagnes Streaming TV, vos campagnes avec leurs mots-clés et leurs publicités, vos règles et tout ce que Gloriads a fait sur Amazon : Ce que lit l'API liste chaque endpoint avec un exemple. La référence de l'API détaille chaque paramètre et chaque réponse, avec un bouton Try it.

Limites

60 requêtes par minute et 10 000 par jour et par compte. Au-delà de l'une ou de l'autre, l'API répond 429 avec un en-tête Retry-After : voir Erreurs.