News Factory for developers and AI agents
Everything News Factory does with stories, content sources, RSS feeds and workflows is available through a REST API: find news in your niche, turn articles into stories with AI, check them for quality and SEO, translate them and publish them to your site. The reference is public and written so that both people and AI agents can use it on their own.
Documentation
- API reference: guides and every endpoint, one page.
- OpenAPI 3.1 specification: generate a client, or give it to an agent as tools (each operation has an
operationId). - llms.txt and llms-full.txt: the reference for large language models, as an index and as one Markdown file.
- MCP server at
https://client-api.news-factory.app/mcp: connect an AI agent (Claude Code, Cursor, any MCP client) with an API key and every endpoint becomes a tool.
Get started
- The API is included in the Pro, Business and Enterprise plans. See the plans.
- An organization admin creates an API key in the app under Organization settings, API keys, and picks what it may do.
- Call
GET /v1/mewith the key: it tells you the organization, the key's scopes and the Topic Workspaces it can use.
curl https://client-api.news-factory.app/v1/me \
-H "Authorization: Bearer $NEWS_FACTORY_API_KEY"Scoped API keys
An organization can hold several keys, each with only the access one integration needs, optionally limited to one Topic Workspace and given an expiry date. Keys are shown once, stored only as a hash, and stop working within a minute of being revoked.
| Scope | Grants |
|---|---|
stories:read | Read stories, their media, quality-check and SEO audit history |
stories:write | Create, update and delete stories; upload, attach and detach media; set thumbnails |
content-sources:read | Read content sources |
content-sources:write | Create, update, delete and scrape content sources |
feeds:read | Read followed feeds, the feed catalogue, feed articles and the scheduler status |
feeds:write | Follow and unfollow feeds, fetch a feed now |
workflows:read | Read workflows, workflow runs and node runs |
workflows:run | Start, pause, resume and stop workflow runs |
ai:generate | Use AI tools that spend AI credits, together with the scope of what they read or change |
Built for AI agents
claude mcp add --transport http news-factory https://client-api.news-factory.app/mcp \
--header "Authorization: Bearer $NEWS_FACTORY_API_KEY"- Over MCP, a key only sees the tools its scopes allow, and every call runs the same checks as the REST API.
- Every error says what went wrong, what to do next and links to its explanation:
{ error: { code, message, details, requestId, docs } }. - A scope error lists exactly which scopes are missing; a Topic Workspace error lists the valid ones.
- The reference includes step-by-step recipes: write a story from a web article, check and improve it, translate it, pick relevant news from followed feeds, run a workflow and wait for it.
- Rate limits come with
Retry-AfterandRateLimitheaders, so an agent can pace itself.
Questions
Write to support@news-factory.app, and include the requestId of the response you are asking about.