Analytics

GET/v1/books/{bookId}/analyticsscope: analytics:read

Per-chapter reader telemetry for a published book — total page views, audio starts, audio completions, and a derived completion rate. Returns empty values until the reader emits events; the reader pings the events endpoint on view and on audio start/complete with a coarse daily anon hash (no PII).

{
  "data": {
    "bookViews": 412,
    "chapters": [
      {
        "chapterId": "ch_…",
        "order": 1,
        "title": "Across the Pyrenees",
        "views": 380,
        "listenStarts": 120,
        "listenCompletes": 71,
        "completionRate": 59.2
      }
    ]
  }
}

Use the per-chapter views and completionRate to find drop-off points and decide where a rewrite would pay off.