Feeds

Connect a feed

Connect an RSS or Atom feed: a feed's address, or a page's (a forum, a community, a blog), in which case the feed the page advertises is used, else a usual address such as /feed or /rss. 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. A new feed brings each reading keyword the newest 10 items of the last 30 days that hold its term, never as instant alerts. A feed the workspace reads already comes back with 200 (connecting is idempotent). A members-only forum answers feed_login_required: send it again with auth (a cookie or a header), stored encrypted and read for this workspace alone.

post/v1/feeds

Request

  • Base URL: https://api.mentio.dev
  • URL: https://api.mentio.dev/v1/feeds
  • Auth: HTTP bearer

Request body

urlstring required

A feed's address (https://forum.example.com/posts.rss), or a page's (https://forum.example.com): the feed the page advertises is used.

Response

The workspace reads this feed already

idstring required

Feed id (fd_...).

urlstring required

The feed itself (after redirects, or the one the page advertised): what is polled.

titlestring nullable required

The feed's own title, when it has one.

connectedAtstring required

When the workspace connected it.

readingSincestring required

Nothing published before this is a live mention: the connection, or the last time its sign-in was added or removed (signed in and signed out, a post is read as two different posts, so the switch starts over rather than bill one twice).

Changes

No recorded changes to this operation across all 1 revision of this API.