OverviewPlatformsAPI Reference
Feeds

Connect many feeds

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.

POST
/v1/feeds/import

Authorization

AuthorizationBearer <token>

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

In: header

Request Body

feeds

Up to 100 feeds, each { url } or { url, auth } for a members-only one. Each is checked on its own: one that fails never stops the others.

Items1 <= items <= 100

Response Body

application/json

application/json

application/json

curl -X POST "https://api.mentio.dev/v1/feeds/import" \  -H "Content-Type: application/json" \  -d '{    "feeds": [      {        "url": "string"      }    ]  }'
{
  "data": [
    {
      "url": "string",
      "status": "added",
      "feed": {
        "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": "feed_login_required",
        "message": "string"
      }
    }
  ]
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}

Get a feed GET

Previous Page

List feeds GET

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.