---
title: "List feeds"
description: "The RSS and Atom feeds the workspace reads (forums, communities, blogs), newest connection first, each with how its hourly poll goes. Every keyword of the workspace with readsWorkspaceFeeds (the default) reads these feeds: an item holding its term is one of its mentions, with its matching rules, billed like any mention. Each feed is read every hour; reading it is free. At most 500 a workspace."
canonical: https://docs.mentio.dev/api/feeds/list-feeds
markdown: https://docs.mentio.dev/api/feeds/list-feeds.mdx
---

# List feeds

`GET /v1/feeds`

The RSS and Atom feeds the workspace reads (forums, communities, blogs), newest connection first, each with how its hourly poll goes. Every keyword of the workspace with readsWorkspaceFeeds (the default) reads these feeds: an item holding its term is one of its mentions, with its matching rules, billed like any mention. Each feed is read every hour; reading it is free. At most 500 a workspace.

## Parameters

- `q` (query): Only feeds whose address or title contains this text, case-insensitive.
- `limit` (query): Feeds per page, at most 500; default 100.
- `offset` (query): Feeds to skip, for the next page.

## Responses

- 200: A page of feeds
- 401: Missing or invalid API key

Full schemas: https://api.mentio.dev/v1/openapi.json. Conventions: https://docs.mentio.dev/conventions.mdx