---
title: "Get feed"
method: POST
path: "/get_feed"
---

# Get feed

`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`)

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

## Request body

- object
  - `feed_id` integer, 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 `200`

Success

- Feed
  - `id` integer
  - `title` string, nullable
  - `url` string
  - `site_url` string, nullable
  - `folder` string, nullable
  - `last_polled_at` string, date-time, nullable
  - `error_count` integer
  - `last_error` string, nullable
  - `host_errors` object, 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.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `402`: Subscription required (trial expired or cancelled)
- `429`: Too many calls. Either the per-account rate limit ({error: "rate_limited", message}) or the account's in-flight work ({error: <sentence>, code: "busy"}). Wait Retry-After seconds.
- `500`: Server error on our side (error: internal_error). The team has been notified.
- `503`: Temporarily unable to answer. error: timeout (the request ran too long; narrow it), server_busy or tier_unavailable (retry after Retry-After seconds when sent).

---

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