Documentation

One dashboard for your whole publishing business: royalties from 31 platforms, ad spend, Kindle Unlimited, series, reviews and links — and the real profit.

Create your account, install the extension, connect KDP and Amazon Ads, and get your catalogue, sales and first real net-profit number in about five minutes.

Where each number comes from: a session captured once and read by our servers for each store, the Amazon Ads API for spend, and the calculations on top.

The Platforms page — every platform in one grid, what each status means, what you can connect today, and how to connect one early, before we start reading it.

The TrueRoyalties Connector links your platforms by capturing the one session our servers then read from — only Draft2Digital is still read from your browser.

What TrueRoyalties imports from KDP, how the first import of your full history works, and why one KDP account maps to exactly one TrueRoyalties account.

Connect your Amazon Ads account to turn royalties into profit — what is imported, how spend is attributed to books, and what the first backfill looks like.

Connect your Meta ad account so your Facebook and Instagram spend lands in each book's net profit, with your past spend imported and the VAT on your invoices.

Connect your TikTok ad account so your BookTok spend lands in each book's net profit, with your past spend imported, VAT on your invoices and deleted ads kept.

When TrueRoyalties refreshes your data, how fresh Amazon's own reports are, why the last 60 days are re-read, and how to force a sync when you need one.

The one number TrueRoyalties exists for — what goes into it, what stays out, and why royalties are shown before tax but profit after, per book and per day.

How TrueRoyalties splits your sales between the ones your ads brought in and the ones that came on their own — where the numbers come from, and their limits.

Ad spend divided by the royalties your ads actually earned, with Amazon on both sides. Break-even is 100 % — and why that beats plain ACOS for an author.

Set VAT on ad spend and KDP withholding once, pick your reporting currency, and every figure in the app becomes the amount that actually reaches your bank.

What Kindle Unlimited pays, what a "page read" really means, why the rate changes every month, where it comes from, and how to read our free rate page.

Narrow every figure to the platforms you choose, wherever the filter appears — what changes in your net profit when you leave one out, and what it does not do.

Your headline numbers, the profit chart, and the books making or losing you the most money — plus the filters and pinned widgets that make the dashboard yours.

Pin any chart from Comparison — the world map included — or the Marketplaces table, to the bottom of your dashboard, and arrange them the way you work.

Units sold, split between what your ads brought in and what sold on its own — by format, marketplace and title — and how the two data sources are lined up.

Kindle Unlimited pages read — how many, which books, from which marketplaces, how many your ads paid for, and the rate a page actually earned you each month.

Every title, with its royalties, ad spend, average CPC, net profit and True ACOS — the sortable table that tells you which of your books to keep advertising.

Group the editions of one book, archive the books that stopped selling, rename what you see — without changing a single figure, and with every change undoable.

Group your books into a series to see read-through from book to book, royalties per reader, and the most you can pay to acquire a reader who enters the series.

Profit country by country — where your catalog earns, where your ads leak, all in one currency with VAT applied per country, ready for your dashboard.

Slice any metric by book, marketplace, format, platform, publication year or period — the free-form view for the questions the other pages do not answer.

See which ads outside Amazon — Facebook, TikTok, Google, your newsletter — bring Amazon sales, Kindle Unlimited pages and royalties, and what each one cost.

Every Amazon review of your books, from each storefront selling them, in one place — how they are collected and refreshed, with an alert when a new one lands.

One link. Every reader lands in their own Amazon store — one that actually sells your book — and you can re-point it later without reprinting anything.

Publish a public page of your KDP royalties that other people can actually trust — prove it is yours, share it, and choose exactly how much of it to show.

Your revenue split by storefront instead of by country, the titles each storefront sold — and the free downloads that never show up on any royalty statement.

Record the money TrueRoyalties cannot read on its own — a book fair, a direct sale, an advance — so your net profit covers your whole publishing business.

When you need your own barcode on a KDP cover (most books do not), where it goes, what the five-digit price block means, which file to use, and how to make one.

Five plans, each covering your monthly royalties up to a cap. You choose yours, every feature is included on every plan, and TrueRoyalties takes no commission.

How the 14-day free trial works, adding a payment method, finding your invoices, changing plan or going annual, and how to cancel or delete your account.

A map of every settings tab — preferences, platforms, taxes, notifications, billing, API, security and account — and what you can change in each of them.

Create an API key, make your first call and read the answer. The TrueRoyalties API lets a spreadsheet, a script or an automation read your own figures.

How to send your API key, how many keys you can hold, what a key can and cannot do, what to do when one leaks, and how to disconnect a connected AI assistant.

The API's request limits and rate-limit headers, the shape of an error, what every error code means, and the rules for periods, currencies, rounding and pages.

Import one line per book — royalties, ad spend, net profit — into a Google Sheet with a short Apps Script, with your API key kept safely out of the sheet.

Ask claude.ai, ChatGPT, Claude Code, Cursor, VS Code or Claude Desktop about your royalties, ad spend and net profit: it reads the same figures as the app.

The eight reasons a TrueRoyalties figure does not match KDP or the Amazon Ads console, from the date range to VAT — almost always a definition, not a bug.

The common symptoms — extension not detected, import stuck, no ad spend, missing reviews, a missing book, trouble signing in — and the fix for each one.

What TrueRoyalties reads, what it never sees, what a smart link records about the people who click it, where your data lives, and what happens if you leave.