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.