Erste Schritte mit der API

Mit der Gloriads-API lesen Ihre eigenen Tools – eine Tabelle, ein Skript, eine Automatisierung – Ihr Konto aus.

Sie ist schreibgeschützt. Ein Schlüssel liest Ihr Konto und ändert nichts. Die API ist in jedem Tarif und während der kostenlosen Testphase enthalten.

Um einem KI-Assistenten Fragen zu Ihrem Konto zu stellen, brauchen Sie keinen Schlüssel: siehe KI-Assistenten verbinden.

1. Schlüssel erstellen

Einstellungen → API → Schlüssel erstellen. Benennen Sie ihn nach dem Tool, das ihn verwenden wird, und kopieren Sie den Schlüssel. Er beginnt mit key_live_ und wird nur einmal angezeigt.

Wie viele Schlüssel Sie haben können und wie Sie einen widerrufen: Authentifizierung und API-Schlüssel.

2. Ersten Aufruf senden

Jede Anfrage geht an https://gloriads.com/api/v1 und trägt Ihren Schlüssel im Header Authorization:

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

/account beweist, dass der Schlüssel funktioniert, beschreibt das Konto, zu dem er gehört, und sagt, bis zu welchem Tag Ihre Amazon-Ads-Zahlen reichen:

{
  "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
    }
  }
}

Steht connection auf error, verbinden Sie Amazon Ads unter Einstellungen → Amazon Ads erneut: Bis dahin werden die Zahlen nicht mehr aktualisiert.

3. Alle Endpunkte erkunden

Ihre Leistung im Vergleich zu einem früheren Zeitraum, Ihre Produkte, Ihre Streaming-TV-Kampagnen, Ihre Kampagnen mit ihren Keywords und Anzeigen, Ihre Regeln und alles, was Gloriads bei Amazon getan hat: Was die API liest listet jeden Endpunkt mit einem Beispiel auf. Die API-Referenz zeigt jeden Parameter und jede Antwort, mit einer Schaltfläche Try it zum Ausprobieren.

Limits

60 Anfragen pro Minute und 10.000 pro Tag pro Konto. Wird eine Grenze überschritten, antwortet die API mit 429 und einem Header Retry-After: siehe Fehler.