Aan de slag met de API

Maak een API-sleutel aan, doe je eerste aanroep en lees het antwoord. Met de TrueRoyalties-API leest een spreadsheet, een script of een automatisering je cijfers.

Met de TrueRoyalties-API lezen je eigen tools — een spreadsheet, een script, een automatisering — de cijfers die je in de app ziet: royalty's, advertentie-uitgaven en nettowinst, per boek en per marketplace, plus gelezen Kindle Unlimited-pagina's, gratis downloads en het doorlezen van reeksen.

Hij is alleen-lezen. Een sleutel leest je hele account en verandert niets: geen synchronisatie, geen instelling, geen boek. De API zit in elk abonnement en in de gratis proefperiode.

Om claude.ai of ChatGPT naar je cijfers te vragen heb je geen sleutel nodig: zie Een AI-assistent koppelen.

1. Maak een sleutel aan

Instellingen → API → Sleutel aanmaken. Geef hem de naam van de tool die hem gebruikt, bijvoorbeeld "Google Sheets", en kopieer de sleutel. Hij begint met tr_live_ en wordt maar één keer getoond.

Het tabblad API in Instellingen, met één sleutel genaamd Google Sheets, het begin van de sleutel, de aanmaakdatum en "Nooit" als laatste gebruik

Hoeveel sleutels je kunt hebben en hoe je er een intrekt: Authenticatie en API-sleutels.

2. Doe je eerste aanroep

Elk verzoek gaat naar https://author.trueroyalties.com/api/v1 en draagt je sleutel in de header Authorization:

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

/account is een goede eerste aanroep: hij bewijst dat de sleutel werkt en laat zien hoe actueel je gegevens zijn.

{
  "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. Vraag je cijfers op

/summary geeft de totalen van een periode, dezelfde cijfers als de kaarten van je dashboard:

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

Drie velden om in elk rapport te lezen:

Veld	Wat het je vertelt
`period`	De precieze dagen, en de tijdzone die bepaalt welke dag "vandaag" is.
`currency`	De valuta van elk bedrag. Standaard je rapportagevaluta; voeg `currency=EUR` toe om die te wijzigen.
`meta.truncated`	`true` als sommige rijen niet gelezen konden worden, zodat de cijfers te laag kunnen zijn. Vraag een kortere periode op.

Periodes, valuta en afronding worden uitgelegd in Limieten en fouten.

Wat je kunt lezen

Endpoint	Geeft
`GET /api/v1/account`	Rapportagevaluta, abonnement, gekoppelde platforms en hun laatste synchronisatie
`GET /api/v1/summary`	De totalen van een periode
`GET /api/v1/timeline`	Dezelfde cijfers, per dag of per maand
`GET /api/v1/reports/books`	Eén regel per boek
`GET /api/v1/reports/marketplaces`	Eén regel per marketplace
`GET /api/v1/books`	Je catalogus
`GET /api/v1/series`	Je reeksen, met hun boeken op volgorde
`GET /api/v1/kenp`	Gelezen Kindle Unlimited-pagina's
`GET /api/v1/kenp/books`	Gelezen pagina's, per boek
`GET /api/v1/free-units`	Gratis downloads, nooit geteld als royalty's
`GET /api/v1/series/{series_id}/read-through`	Het doorlezen van één reeks, per boek

Elke parameter en elk veld staat in de API-referentie (in het Engels). De knop Try it is vooraf ingevuld met een openbare demosleutel: je kunt elk endpoint zonder account testen, en de antwoorden komen dan uit de fictieve cijfers van het demo-account.

Instellingen Authenticatie en API-sleutels