Primeros pasos con la API

Crea una clave de API, haz tu primera llamada y lee la respuesta. La API de TrueRoyalties permite que una hoja de cálculo, un script o una automatización lean tus cifras.

La API de TrueRoyalties permite que tus propias herramientas — una hoja de cálculo, un script, una automatización — lean las cifras que ves en la app: regalías, gasto en anuncios y beneficio neto, por libro y por marketplace, además de las páginas leídas de Kindle Unlimited, las descargas gratuitas y la lectura de las series.

Es de solo lectura. Una clave lee toda tu cuenta y no cambia nada: ninguna sincronización, ningún ajuste, ningún libro. La API está incluida en todos los planes y durante la prueba gratuita.

Para preguntar a claude.ai o ChatGPT por tus cifras no necesitas clave: consulta Conectar un asistente de IA.

1. Crea una clave

Ajustes → API → Crear una clave. Ponle el nombre de la herramienta que la va a usar, por ejemplo «Google Sheets», y copia la clave. Empieza por tr_live_ y se muestra una sola vez.

La pestaña API de Ajustes, con una clave llamada Google Sheets, el inicio de la clave, su fecha de creación y «Nunca» como último uso

Cuántas claves puedes tener y cómo revocar una: Autenticación y claves de API.

2. Haz tu primera llamada

Cada petición va a https://author.trueroyalties.com/api/v1 y lleva tu clave en la cabecera Authorization:

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

/account es una buena primera llamada: demuestra que la clave funciona y te dice lo actualizados que están tus datos.

{
  "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. Pide tus cifras

/summary devuelve los totales de un periodo, las mismas cifras que las tarjetas de tu panel:

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

Tres campos que leer en cada informe:

Campo	Lo que te dice
`period`	Los días exactos cubiertos, y la zona horaria que decide qué día es «hoy».
`currency`	La moneda de cada importe. Por defecto, tu moneda de informes; añade `currency=EUR` para cambiarla.
`meta.truncated`	`true` cuando algunas filas no se pudieron leer, así que las cifras pueden quedarse cortas. Pide un periodo más corto.

Los periodos, las monedas y el redondeo se explican en Límites y errores.

Lo que puedes leer

Endpoint	Devuelve
`GET /api/v1/account`	Moneda de informes, suscripción, plataformas conectadas y su última sincronización
`GET /api/v1/summary`	Los totales de un periodo
`GET /api/v1/timeline`	Las mismas cifras, día a día o mes a mes
`GET /api/v1/reports/books`	Una línea por libro
`GET /api/v1/reports/marketplaces`	Una línea por marketplace
`GET /api/v1/books`	Tu catálogo
`GET /api/v1/series`	Tus series, con sus libros en orden
`GET /api/v1/kenp`	Páginas leídas de Kindle Unlimited
`GET /api/v1/kenp/books`	Páginas leídas, libro por libro
`GET /api/v1/free-units`	Descargas gratuitas, nunca contadas como regalías
`GET /api/v1/series/{series_id}/read-through`	La lectura de una serie, libro por libro

Cada parámetro y cada campo están en la referencia de la API (en inglés). Su botón Try it viene rellenado con una clave de demo pública: puedes probar cada endpoint sin cuenta, y las respuestas vienen entonces de las cifras ficticias de la cuenta demo.

Ajustes Autenticación y claves de API