---
method: GET
path: /api/analytics/popular-books
auth: jwt
area: analytics
---
<!-- source: internal/handlers/analytics.go PopularBooksResponse / GetPopularBooks -->

# Get Popular Books

Most-read books for the signed-in user.

## Example response

```json example-response
{
  "books": [
    {
      "media_item_id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "1984",
      "author": "George Orwell",
      "read_count": 3,
      "avg_completion": 0.95,
      "last_read": "2026-10-24T13:57:01Z"
    }
  ]
}
```

## Query parameters

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| limit     | int  | No       | Result cap; default `10` |

There is no date-range filtering on this endpoint — the ranking is
computed over all reading history.

## Errors

| Status | Body | When |
| ------ | ---- | ---- |
| 500 | `{"error": "..."}` | unexpected server error |