Erste Schritte mit der API

Erstelle einen API-Schlüssel, mach deinen ersten Aufruf und lies die Antwort. Mit der TrueRoyalties-API liest eine Tabelle, ein Skript oder eine Automatisierung deine Zahlen.

Mit der TrueRoyalties-API lesen deine eigenen Tools — eine Tabelle, ein Skript, eine Automatisierung — die Zahlen, die du in der App siehst: Tantiemen, Werbeausgaben und Nettogewinn, pro Buch und pro Marktplatz, dazu gelesene Kindle-Unlimited-Seiten, Gratis-Downloads und das Weiterlesen in Reihen.

Sie ist nur lesend. Ein Schlüssel liest dein ganzes Konto und ändert nichts: keine Synchronisierung, keine Einstellung, kein Buch. Die API ist in jedem Tarif und während der kostenlosen Testphase enthalten.

Um claude.ai oder ChatGPT nach deinen Zahlen zu fragen, brauchst du keinen Schlüssel: siehe KI-Assistenten verbinden.

1. Schlüssel erstellen

Einstellungen → API → Schlüssel erstellen. Benenne ihn nach dem Tool, das ihn nutzt, zum Beispiel „Google Sheets“, und kopiere den Schlüssel. Er beginnt mit tr_live_ und wird nur ein einziges Mal angezeigt.

Der Tab API in den Einstellungen, mit einem Schlüssel namens Google Sheets, dem Anfang des Schlüssels, seinem Erstelldatum und „Nie“ als letzter Verwendung

Wie viele Schlüssel du haben kannst und wie du einen widerrufst: Authentifizierung und API-Schlüssel.

2. Erster Aufruf

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

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

/account ist ein guter erster Aufruf: Er beweist, dass der Schlüssel funktioniert, und zeigt, wie aktuell deine Daten sind.

{
  "reporting_currency": "USD",
  "is_demo": false,
  "subscription": { "status": "active" },
  "platforms": [
    {
      "platform_id": "amazon-kdp",
      "name": "Amazon KDP",
      "connected": true,
      "last_sync_at": "2026-09-15T08:02:11.000Z",
      "sync_status": "success",
      "covered_through": "2026-09-14"
    }
  ],
  "api_key": {
    "name": "Google Sheets",
    "start": "tr_live_ab12",
    "scopes": ["read"],
    "created_at": "2026-09-15T07:55:00.000Z",
    "last_used_at": null
  },
  "connected_app": null
}

3. Zahlen abrufen

/summary liefert die Summen eines Zeitraums, dieselben Zahlen wie die Karten deines Dashboards:

curl "https://author.trueroyalties.com/api/v1/summary?range=last_30_days" \
  -H "Authorization: Bearer YOUR_API_KEY"

Drei Felder, die du in jedem Bericht liest:

Feld	Was es dir sagt
`period`	Die genauen Tage, und die Zeitzone, die festlegt, welcher Tag „heute“ ist.
`currency`	Die Währung jedes Betrags. Standard ist deine Berichtswährung; mit `currency=EUR` änderst du sie.
`meta.truncated`	`true`, wenn manche Zeilen nicht gelesen werden konnten und die Zahlen zu niedrig sein können. Frag einen kürzeren Zeitraum ab.

Zeiträume, Währungen und Rundung erklärt Limits und Fehler.

Was du lesen kannst

Endpoint	Liefert
`GET /api/v1/account`	Berichtswährung, Abo, verbundene Plattformen und ihre letzte Synchronisierung
`GET /api/v1/summary`	Die Summen eines Zeitraums
`GET /api/v1/timeline`	Dieselben Zahlen, Tag für Tag oder Monat für Monat
`GET /api/v1/reports/books`	Eine Zeile pro Buch
`GET /api/v1/reports/marketplaces`	Eine Zeile pro Marktplatz
`GET /api/v1/books`	Dein Katalog
`GET /api/v1/series`	Deine Reihen, mit ihren Büchern in Reihenfolge
`GET /api/v1/kenp`	Gelesene Kindle-Unlimited-Seiten
`GET /api/v1/kenp/books`	Gelesene Seiten, Buch für Buch
`GET /api/v1/free-units`	Gratis-Downloads, nie als Tantiemen gezählt
`GET /api/v1/series/{series_id}/read-through`	Das Weiterlesen einer Reihe, Buch für Buch

Jeder Parameter und jedes Feld steht in der API-Referenz (auf Englisch). Ihr Button Try it ist mit einem öffentlichen Demo-Schlüssel vorausgefüllt: Du kannst jeden Endpoint ohne Konto testen, die Antworten kommen dann aus den fiktiven Zahlen des Demo-Kontos.

Einstellungen Authentifizierung und API-Schlüssel