Get new articles

Articles since this token's last visit, oldest-first; advances a per-token cursor. has_more=true means more remain. mark_seen=false peeks; exclude_feed_ids skips noisy feeds. feed_warnings and watch_summaries, when present, report failing feeds and saved-watch matches.

post/get_new_articles

Request

  • Base URL: https://newsmind.app/api/v1
  • URL: https://newsmind.app/api/v1/get_new_articles
  • Auth: OAuth 2 (authorization code, authorization URL https://newsmind.app/oauth/authorize, token URL https://newsmind.app/oauth/token, scopes: mcp)

Request body

max_itemsinteger

Max articles per batch (1-100, default 50). Values above 100 are silently clamped. Cursor only advances over what's returned, so older unseen articles aren't silently skipped. If the result hits this cap, has_more is true and you should call again to fetch the next batch.

mark_seenboolean

If false, peek without advancing the cursor (subsequent default-mode call commits).

exclude_feed_idsinteger[]

Exclude articles from these feeds. Useful when a high-volume feed (HN, WIRED) is overwhelming the queue.

Response

Success

countinteger
has_moreboolean
cursor_advancedboolean

Changes

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