# Newsboy — Verified News Intelligence API
> newsboy.drm3.network

News intelligence for AI agents and humans. 5,500+ curated RSS feeds, 43 languages.
63 structured fields per article. Ed25519 provenance on every article.

## Endpoints
- GET /v1/search?q={query}&since=7d&limit=20&kind= — Full-text search
- GET /v1/articles?topic=&category=&language=&since=24h&kind= — Browse
- GET /v1/articles/{id} — Article detail with all fields
- GET /v1/articles/{id}/provenance — Ed25519 receipt chain
- GET /v1/ask?q={question}&kind= — Retrieve-then-reason cited answer
- GET /v1/signals?ticker=TSLA&direction=DOWN — Momentum signals
- GET /v1/topics?since=24h — Trending topics
- GET /v1/entities?name=Jensen+Huang&type=person&kind= — Entity search
- GET /v1/events?since=7d&type=deadline&kind= — Event calendar
- GET /v1/facts?subject=Federal+Reserve — Fact search
- GET /health — Service health

## Content kinds (added 2026-06-12)
Every article carries a kind: news | blog | release_notes | spec | forum_social.
Filter with kind= (comma-separated multi-value, e.g. kind=news,blog — invalid
values are a 400). No kind param = all kinds. News surfaces (homepage, digests,
movers) default to news+blog; dev content (Reddit/HN threads, GitHub release
notes, EIP/RFC specs) is segmented behind kind=, not dropped — e.g.
kind=release_notes,spec,forum_social is the dev-radar slice.

## MCP (Model Context Protocol)
Streamable HTTP MCP server at POST /mcp — 10 tools (search_news, get_article,
get_signals, get_trending_topics, search_entities, get_events, search_facts, ...).
Client config: GET /mcp.json

## Authentication
X-Newsboy-Key header or Authorization: Bearer. All /v1/* endpoints require a key.
Free key (100 req/day): POST /billing/signup {"email": "..."} — or use the
pricing page at /ui#/pricing. Paid tiers: Dev $29/mo (2k/day), Pro $49/mo
(10k/day), Scale $199/mo (100k/day). Usage: GET /v1/usage with your key.

Newsboy is an open alpha — expect schema additions and visible sync lag on /health.