Was die API liest

Die API liest dieselben Zahlen, die Sie in Gloriads sehen. Sie ändert nie Ihr Konto oder Ihre Anzeigen.

Endpunkte

Jeder Parameter und jedes Feld steht in der API-Referenz, mit einer Schaltfläche Try it zum Ausprobieren.

Zeiträume

/summary, /timeline und /reports/products decken einen Zeitraum ab. Senden Sie eine dieser beiden Angaben:

• Ohne Angabe: last_30_days, wie im Dashboard.
• Ein range umfasst vollständige Tage, genau die, die das Dashboard summiert: last_30_days sind die 30 Tage bis gestern, und this_month und this_year enden gestern. Amazon ordnet einen Verkauf seinem Klick erst Tage später zu, daher ist der heutige Tag nie vollständig.
• today ist der heutige Tag, ebenso this_month am 1. des Monats (er hat dann noch keinen vollständigen Tag).
• all_time beginnt mit dem ältesten Tag, den Gloriads gespeichert hat, und reicht bis heute, wie Gesamter Zeitraum im Dashboard.
• Um den heutigen Tag einzuschließen, senden Sie start_date und end_date mit end_date = heute.
• timezone (Europe/Paris, America/New_York …) legt fest, welcher Tag „heute“ ist. Standardmäßig UTC.
• Jede Antwort nennt in period die Tage, die sie abdeckt.

Zwei Zeiträume vergleichen

Fügen Sie compare zu /summary, /timeline oder /reports/products hinzu, wie Vergleichen mit im Dashboard:

Die Antwort enthält dann zusätzlich comparison mit den Zahlen des Vergleichszeitraums. Für Ausgaben, Umsatz, ACOS, Impressionen, Klicks, CPC und Käufe nennt sie außerdem die Veränderung jeder Kennzahl:

"changes": {
  "spend": { "kind": "change", "percent": 18.2, "direction": "up", "tone": "neutral" },
  "acos": { "kind": "change", "percent": -6.5, "direction": "down", "tone": "good" }
}

• Beide Zeiträume enden gestern, wie im Dashboard: Reicht ein Zeitraum bis heute, fällt der heutige Tag weg, und period zeigt das.
• kind: "new" bedeutet, dass die Kennzahl vorher null war; kind: "none" bedeutet, dass es nichts zu vergleichen gibt (ACOS ohne Umsatz).
• tone sagt, ob die Veränderung gut ist, wie die Farben im Dashboard. Die Ausgaben sind immer neutral.
• all_time hat keinen Zeitraum davor, und today hat keinen vollständigen Tag: comparison nennt dann in unavailable den Grund.
• Speichert Gloriads keine Historie für den Vergleichszeitraum, sind dessen Zahlen null, und history_covered ist false.

Filter

Ein unbekannter Wert wird mit 400 abgelehnt, und die Antwort nennt ihn. Er wird nie mit Nullen beantwortet.

Summen eines Zeitraums

curl "https://gloriads.com/api/v1/summary?range=last_month&marketplaces=US" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "period": { "start_date": "2026-09-01", "end_date": "2026-09-30", "range": "last_month", "timezone": "UTC" },
  "currency": "USD",
  "spend": 13140.53,
  "sales": 46562.2,
  "acos": 28.22,
  "roas": 3.54,
  "impressions": 3945723,
  "clicks": 13973,
  "ctr": 0.35,
  "average_cpc": 0.94,
  "purchases": 1479,
  "conversion_rate": 10.58,
  "by_marketplace": [ … ],
  "by_ad_product": [ … ],
  "meta": { "data_last_date": "2026-10-09", "history_covered": true, "truncated": false }
}

• acos, ctr und conversion_rate sind Prozentwerte: 28.22 bedeutet 28,22 %.
• purchases zählt Bestellungen, wie Käufe in der Werbekonsole, keine Einheiten.
• Ein Verhältnis ohne Basis (ACOS ohne Verkauf) ist null, nie 0.

Tag für Tag oder Monat für Monat

/timeline nimmt denselben Zeitraum und dieselben Filter entgegen und liefert in data einen Punkt pro Tag oder pro Monat.

• granularity=auto (der Standard) wählt Tage bis 92 Tage, darüber Monate, wie das Diagramm des Dashboards.
• granularity=day wird bei einem Zeitraum von mehr als 92 Tagen abgelehnt.
• Ein Tag ganz ohne Zahlen wird weggelassen.

Pro Produkt

/reports/products liefert eine Zeile pro beworbenem Produkt (ASIN), sortiert nach sort (standardmäßig spend) und order (standardmäßig desc).

• product_id: null fasst zusammen, was Amazon keinem Produkt zuordnet, meist Sponsored Brands.
• title ist der Name des Produkts, wie ihn Amazons Produktbericht liefert, auf dem Marktplatz, auf dem es im Zeitraum am meisten ausgegeben hat. Er ist null bei product_id: null und solange Gloriads die Produkttitel des Kontos noch nicht von Amazon erhalten hat.
• Die Zeilen kommen seitenweise: siehe Limits und Fehler.

Streaming TV

Die anderen Berichte lassen Streaming TV (TV-Anzeigen auf Prime Video und in Streaming-Apps) weg, wie das Dashboard: Amazon nimmt es nicht in den Bericht auf, aus dem sie stammen. /reports/streaming-tv liest es aus einem eigenen Bericht von Amazon, für einen Marktplatz.

curl "https://gloriads.com/api/v1/reports/streaming-tv?marketplace_id=3478512345678901&range=last_30_days" \
  -H "Authorization: Bearer YOUR_API_KEY"

• Ein Zeitraum von höchstens 31 Tagen, innerhalb der letzten 95 Tage: die Limits von Amazon für diesen Bericht.
• Der erste Aufruf für einen Zeitraum kann "status": "pending" liefern, während Amazon den Bericht erstellt. Das dauert meist einige Minuten. Rufen Sie nach meta.retry_after_seconds erneut auf. Der Bericht wird dann 3 Stunden lang gespeichert.
• Jede Kampagne enthält ihre Ausgaben, Impressionen, cpm (Kosten pro 1.000 Impressionen), Klicks, Umsatz, Käufe und units_sold.
• Die Beträge stehen in der eigenen Währung des Marktplatzes, nicht in USD.
• "status": "unavailable": Amazon bietet diesem Konto kein Streaming TV an, zum Beispiel dem Konto eines KDP-Autors.

Kampagnen und Anzeigengruppen

Beide brauchen marketplace_id: eine id aus /marketplaces.

curl "https://gloriads.com/api/v1/campaigns?marketplace_id=3478512345678901&states=ENABLED" \
  -H "Authorization: Bearer YOUR_API_KEY"

• Sie listen aktive und pausierte Kampagnen von Sponsored Products, Sponsored Brands und Display auf. Archivierte Kampagnen werden nie aufgeführt.
• Budgets und Gebote stehen in der eigenen Währung des Marktplatzes (currency_code in /marketplaces).
• provenance sagt, ob Gloriads die Kampagne erstellt, geändert oder nie angefasst hat.
• /ad-groups?campaign_id=… behält nur die Anzeigengruppen einer Kampagne.
• Bis zu 1.000 Zeilen pro Seite (standardmäßig 100).

Keywords, Targeting-Elemente und Anzeigen

/targets und /ads listen auf, was in einer Kampagne steckt. Beide brauchen marketplace_id und campaign_id; ad_group_id behält nur eine ihrer Anzeigengruppen.

curl "https://gloriads.com/api/v1/targets?marketplace_id=3478512345678901&campaign_id=28430987654321" \
  -H "Authorization: Bearer YOUR_API_KEY"

• /targets listet jedes Keyword mit seinem match_type (EXACT, PHRASE, BROAD) auf. Dazu kommen die Targeting-Elemente für Produkte (ASINs) und Kategorien, die Targeting-Gruppen automatischer Kampagnen und die negativen Keywords und Targeting-Elemente, jeweils mit bid und Status. bid: null bedeutet, dass es das Standardgebot der Anzeigengruppe bietet.
• /ads listet jede Anzeige mit den Produkten auf, die sie bewirbt (product_ids).
• Beide werden im Moment Ihrer Anfrage bei Amazon gelesen und enthalten keine Zahlen.
• Sponsored Products, Sponsored Brands und Display. Archivierte Elemente werden nie aufgeführt.
• Bis zu 1.000 Zeilen pro Seite (standardmäßig 100).

Regeln und Aktivitäten

• /rules listet jede Regel auf, die zuletzt bearbeitete zuerst.
• /rules/{rule_id}/runs zeigt, was jede der letzten Ausführungen geprüft und geändert hat. Testläufe werden nicht aufgeführt.
• /activity listet jeden Vorgang auf, den Gloriads bei Amazon ausgeführt hat: eine erstellte oder kopierte Kampagne, hinzugefügte Produkte, die Änderungen einer Regel, ein Rückgängigmachen. Die Ausführung einer Regel erscheint einmal pro Marktplatz, mit derselben rule_run_id. tool=rule behält nur die Vorgänge der Regeln.
• /activity/{operation_id} liest einen einzelnen Vorgang: Fragen Sie ihn regelmäßig ab, um einen noch laufenden Vorgang zu verfolgen.
• /activity/{operation_id}/lines listet Zeile für Zeile auf, was der Vorgang getan hat: das Element (Kampagne, Anzeigengruppe, Anzeige oder Targeting-Element), ob es erstellt, geändert oder archiviert wurde, jeden Wert vorher und nachher und den Fehler von Amazon, wenn eine Zeile fehlgeschlagen ist. Bis zu 500 Zeilen pro Seite: Die Ausführung einer Regel kann 5.000 enthalten.

Wie aktuell die Zahlen sind

• Es sind die Zahlen Ihres Dashboards, aus denselben Daten mit demselben Code gelesen.
• Die Leistungsbeträge sind in USD. Amazon rechnet die Zahlen jedes Marktplatzes um.
• Amazon schreibt Verkäufe erst einige Tage nach dem Klick zu, daher wachsen die letzten Tage eines Zeitraums noch eine Weile. meta.data_last_date sagt, bis zu welchem Tag die Zahlen reichen.
• Kampagnen werden pro Marktplatz höchstens alle 30 Minuten bei Amazon gelesen. meta.synced_at sagt, wann. Beim allerersten Aufruf für einen Marktplatz kann die Liste leer sein, mit meta.syncing: true: Rufen Sie eine Minute später erneut auf.
• Die Produktzahlen werden einmal täglich aktualisiert. Ein Zeitraum, der vor der Historie beginnt, die Gloriads gespeichert hat, liefert meta.history_covered: false.
• Keywords, Targeting-Elemente und Anzeigen werden live bei Amazon gelesen, bei jedem Aufruf: meta.read_at sagt, wann.
• Streaming-TV-Zahlen werden 3 Stunden lang gespeichert, nachdem Amazon ihren Bericht erstellt hat: meta.report_ready_at sagt, wann.