OverviewPlatformsAPI Reference
Feeds

List 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.

GET
/v1/feeds

Authorization

AuthorizationBearer <token>

API key minted via POST /v1/api-keys (format mk_live_...)

In: header

Query Parameters

q?string

Only feeds whose address or title contains this text, case-insensitive.

Length1 <= length <= 200
limit?integer

Feeds per page, at most 500; default 100.

Default100
Range1 <= value <= 500
offset?integer|null

Feeds to skip, for the next page.

Default0
Range0 <= value

Response Body

application/json

application/json

curl -X GET "https://api.mentio.dev/v1/feeds"
{
  "data": [
    {
      "id": "string",
      "url": "string",
      "title": "string",
      "connectedAt": "string",
      "readingSince": "string",
      "auth": {
        "type": "cookie"
      },
      "health": {
        "status": "ok",
        "reason": "login_required",
        "detail": "string",
        "failures": 0,
        "since": "string"
      },
      "stats": {
        "lastPolledAt": "string",
        "emptyPolls": 0
      }
    }
  ],
  "total": 0
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}

Connect many feeds POST

Connect up to 100 feeds in one call, each { url } or { url, auth } for a members-only one, checked on its own and reported added, already or failed, in the order sent: one that fails never stops the others. A failure carries the error code POST /v1/feeds would answer for that address (feed_login_required: send it again with auth). 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. The first 8 added bring each reading keyword the newest 10 matching items of the last 30 days; the rest start from now.

Update a feed PATCH

Rename a feed (title, null clears it), or set its sign-in for a members-only forum (auth: a cookie copied from your browser, or one header such as Discourse's Api-Key). A sign-in is checked by reading the feed with it, stored encrypted, sent to the feed's own site alone and never shown again; the feed is then read for this workspace alone. auth: null removes it.