OverviewPlatformsAPI Reference
Feeds

Get a feed

GET
/v1/feeds/{id}

Authorization

AuthorizationBearer <token>

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

In: header

Path Parameters

idstring

Feed id (fd_...).

Length1 <= length

Response Body

application/json

application/json

application/json

curl -X GET "https://api.mentio.dev/v1/feeds/fd_abc123"
{
  "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
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}

Disconnect a feed DELETE

The workspace stops reading the feed. Its mentions stay; a keyword naming the same feed in its own `feeds` keeps reading it.

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.