---
title: "List newsfeed articles"
method: GET
path: "/api/v1/articles"
tags: ["Articles"]
---

# List newsfeed articles

`GET /api/v1/articles`

## Request

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

Returns the authenticated user's newsfeed: articles from every subscribed feed, newest first. Supports full-text search via `q` and date filtering via `published_after` / `published_before`. Paginate with `limit` plus the `before_published_at` and `before_id` cursors taken from the last item of the previous page, and check `meta.has_more` to know whether another page exists. Requires the `read` scope.

## Query parameters

- `limit` integer
- `before_published_at` string, date-time
- `before_id` string, uuid
- `unread_only` 'true' | 'false'
- `count_only` 'true' | 'false'
- `q` string
- `date_from` string, date
- `date_to` string, date
- `sort` 'newest' | 'oldest'

## Response `200`

Paginated article list

- object
  - `data` ArticleV1[], required
    - `id` string, uuid, required
    - `title` string, nullable, required
    - `source` string, nullable, required
    - `url` string, uri, required
    - `published_at` string, date-time, nullable, required
    - `summary_preview` string, nullable, required
    - `image_url` string, uri, nullable, required
    - `is_read` boolean, required
    - `is_saved` boolean, required
    - `tags` string[], required
    - `highlights_count` integer, required
    - `notes_count` integer, required
  - `meta` object, required
    - `has_more` boolean, 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)