---
title: "Get reading statistics"
method: GET
path: "/api/v1/stats"
tags: ["Stats"]
---

# Get reading statistics

`GET /api/v1/stats`

## Request

- Base URL: `https://feednest.com`
- URL: `https://feednest.com/api/v1/stats`
- Auth: HTTP bearer

Returns aggregate reading statistics for the authenticated user: totals for feeds, articles, unread items, saved items, highlights, and notes, plus reading streak data. Useful for building a dashboard or a daily briefing without paging through content. Requires the `read` scope.

## Response `200`

User reading stats

- object
  - `data` StatsV1, required
    - `articles_read_today` integer, required
    - `reading_time_today_minutes` integer, required
    - `streak_days` integer, required
    - `total_feeds` integer, required
    - `unread_count` integer, required
    - `saved_count` integer, required

## Other responses

- `401`: Missing or invalid API key
- `403`: Insufficient permissions or subscription required
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/feednest/apis/feednest-public-api.md) · [All operations](https://skmtc.dev/feednest/apis/feednest-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/feednest/apis/feednest-public-api/revisions/51c8242d8418?raw)