Articles

List newsfeed articles

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.

get/api/v1/articles

Request

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

Query parameters

limitinteger

Maximum items to return (1–100)

before_published_atstring date-time

Cursor: return items published before this timestamp

before_idstring uuid

Cursor: return items with IDs before this value

unread_only'true' | 'false'

When true, only return unread articles

count_only'true' | 'false'

When true, return only the article count ({ count, capped }) instead of the full list. Counts up to 999; capped is true if more exist.

qstring

Full-text search query

date_fromstring date

Filter: articles published on or after this date

date_tostring date

Filter: articles published on or before this date

sort'newest' | 'oldest'

Sort order by published date

Response

Paginated article list

Changes

No recorded changes to this operation across all 1 revision of this API.