API reference

Every endpoint, from the OpenAPI document. New here? Start with the guide. To try a request, paste a token from Account > Developer under Authentication.

Lists and search give titles, links and summaries; full text is one article at a time, 300 a day on Plus, the same count as MCP's. It's all for your own use: see the rules.

Before you build

The rules

The API, the MCP server and RSS app sync are for you: your own reading, your own AI assistant, and automating your own workflow, through your own account.

  • Lists, search and RSS app sync give titles, links and the feed's short summaries. The full text comes one article at a time, when you (or your agent, for you) ask for it, like a browser's Reader View.
  • Full texts are 10 a day on Free and 300 a day on Feedmesh Plus: one count, shared by MCP and the REST API. Account > Usage shows today's.
  • Don't use any of it to bulk-export articles, build datasets (to sell or otherwise), republish or redistribute publishers' articles, or train, fine-tune or ground AI models, or feed an AI product, search index or RAG system that serves anyone but you.
  • One account per person. Don't use extra accounts or tokens to get around the daily amounts.
  • Articles belong to their publishers. Read them for yourself, and link to them rather than copying them.

The legal version is section 5 of the Terms of Service. Feedmesh may limit or stop access that breaks these rules. Not sure whether something fits? Ask at [email protected].