TwoTakes for developers and AI agents

Every TwoTakes story is available as clean JSON and Markdown, free and without an API key. Each story includes what left-leaning outlets emphasize, what right-leaning outlets emphasize, the facts both sides agree on, and links to every source.

Endpoints

• GET /api/v1/stories: newest first. Params: limit (1-50), cursor (from next_cursor), topic, full=false for headlines only.
• GET /api/v1/stories/{slug}: one story in full.
• GET /api/v1/topics: most-covered topics with hub and RSS links.
• OpenAPI 3 spec

Responses use one envelope: { success, data, error }. Errors carry a stable error.code (for example NOT_FOUND, INVALID_CURSOR, UPSTREAM_UNAVAILABLE) and a readable message.

Markdown and feeds

• Add .md to any story URL, or send Accept: text/markdown.
• llms.txt (agent guide) and llms-full.txt (recent stories in full).
• RSS for all stories, and per-topic RSS at /topics/{topic}/feed.xml.

Versioning and fair use

The API is versioned in the path (/api/v1). Breaking changes will ship as a new version, and an old version stays up for at least 90 days after a replacement is announced on this page. Please keep traffic reasonable (about one request per second) and cache responses; they change every few minutes at most.

Attribution

Content by TwoTakes (https://twotakes.us). You may quote, summarize and cite it, including in AI answers, as long as you credit TwoTakes and link the story URL. Original reporting belongs to the linked outlets. Summaries are AI-assisted and reviewed for balance; check the original sources for authoritative reporting.

Questions or a use case we should support? Email hello@twotakes.us.