---
title: "List RSS feeds"
method: GET
path: "/rss-feeds"
tags: ["Posts"]
---

# List RSS feeds

`GET /rss-feeds`

## Request

- Base URL: `https://www.sociahive.com/api/v1`
- URL: `https://www.sociahive.com/api/v1/rss-feeds`
- Auth: one of:
  - API key in header `X-API-Key`
  - OAuth 2 (authorization code, authorization URL `/api/oauth/authorize`, token URL `/api/oauth/token`, scopes: `posts:read`)

Your RSS feeds (at most 5).

## Response `200`

RSS feeds

- object
  - `success` true, required
  - `data` RssFeed[], required
    - `_id` string, required: MongoDB ObjectId (24-character hex string)
    - `url` string, uri, required
    - `platforms` string[], required
    - `active` boolean, required: Polled. Same as `!paused`.
    - `paused` boolean, required
    - `stopped_after_errors` boolean, required: Turned off after 5 failed polls in a row. Resume to try again.
    - `last_polled_at` string, date-time, nullable, required
    - `last_item_id` string, nullable, required
    - `error_count` integer, required
    - `mode` 'draft' | 'ai_draft' | 'ai_schedule', required: `draft`: each new item becomes a draft of its text. `ai_draft`: AI writes the post, it lands as a draft for review. `ai_schedule`: AI writes the post and schedules it into the next free posting slot of the feed's accounts, so it publishes without review. When no slot is free in the next 14 days the post stays a draft and you are notified.
    - `template` RssFeedTemplate, nullable, required
      - `instructions` string
      - `tone` string
    - `image` 'none' | 'feed' | 'ai', required: `feed`: the item's own image, when it has a public https one. `ai`: one AI image, counted against the plan's monthly AI image allowance (none once it is used up).
    - `account_ids` string[], required: Accounts AI posts go to. Empty: the first connected account of each platform.
    - `daily_cap` integer, required: AI posts a day from this feed. Across all feeds a user gets at most 10 AI posts a day.

## Other responses

- `400`: Bad request — invalid parameters
- `401`: Authentication required — provide X-API-Key or Bearer token
- `403`: Insufficient scope for this operation
- `429`: Rate limit exceeded
- `500`: Internal server error

---

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