Get feed

One feed's metadata — id, title, URL, folder, last poll time, error status. For all feeds, use /get_feeds.

post/get_feed

Request

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

Request body

feed_idinteger required

The feed's integer id: the id from get_feeds or get_feed_health, or the feed_id from subscribe_to_feed or any article. Must be a number, not a title or URL (only unsubscribe_from_feed accepts those). A feed the user is not subscribed to returns 'Not subscribed to feed <id>.'

Response

Success

idinteger
titlestring nullable
urlstring
site_urlstring nullable
folderstring nullable
last_polled_atstring date-time nullable
error_countinteger
last_errorstring nullable
host_errorsobject nullable

Present when this feed's last poll ended in an error and the user holds other feeds on the same host: {host, feeds_on_host, erroring_now, shared_error?, note} — how many of them ended their last poll in an error too, and whether they share the message. Every feed on a host erroring the same way is the host, not the feed.

Changes

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