For Developers & Agents
Built to be consumed by machines
AIMode News publishes a read-only, cache-friendly JSON API, an A2A endpoint, an OpenAPI spec, and standard machine-discovery files — so agents, RAG pipelines, and assistants can pull verified headlines with full attribution. Everything on this page is also documented in OpenAPI and llms.txt.
Quickstart
Read without a key
The whole API is public. Anonymous calls are limited to 60 per minute per IP.
curl https://www.aimode.news/api/news?limit=5
Get a free API key
Agents with a real A2A card are issued a key on registration — one key per agent, plaintext shown once.
curl -X POST https://www.aimode.news/api/agents/register \
-H "Content-Type: application/json" \
-d '{"cardUrl": "https://your-agent/.well-known/agent-card.json"}'Call with your key
Standard tier: 600 requests/minute, ten times the anonymous allowance.
curl https://www.aimode.news/api/news?limit=20 \ -H "X-Api-Key: amn_…"
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /api/news | Latest headlines — filter by entity, category, days |
| GET | /api/search?q= | Full-text search across headlines and summaries |
| GET | /api/trending | Most-viewed articles (30-day) |
| GET | /api/topics | Entity topic hubs (OpenAI, Google, Nvidia, …) |
| GET | /api/categories | Editorial categories with article counts |
| GET | /api/sources | Publishers aggregated, with counts and dominant category |
| GET | /api/article/{slug} | Single article by slug |
| GET | /api/agents | Machine-verified agent registrations |
| GET | /api/agents/{slug} | Single agent profile (curated or verified) |
| POST | /api/agents/register | Register an agent's A2A card for verification |
Authentication & rate limits
anon
60 requests/minNone
Start here — fine for prototypes and one-off pulls.
standard
600 requests/minX-Api-Key (free)
Issued automatically once, the first time your agent registers a verified A2A card.
pro
6,000 requests/minX-Api-Key (paid)
Reserved for the paid tier — not yet on sale. Standard tier covers every current use.
Send your key as X-Api-Key or Authorization: Bearer. Successful responses include X-RateLimit-Tier and X-RateLimit-Limit. Over the limit returns 429 with Retry-After: 60. Keys are stored hashed (SHA-256) — the plaintext is shown exactly once, at registration.
Machine discovery files
Agents discover this site the standard way: via well-known files on our domain. About agents.md: that is a convention for AI repositories, not websites — for the web, the files below are the discovery surface, and all are served live.
/.well-known/agent-card.jsonOur A2A v1.0 agent card (the 'agent.json' agents look for)/.well-known/agent.jsonLegacy A2A pre-1.0 alias for older agent SDKs/.well-known/agents.jsonAgent directory file (IsAgentReady check 4.6)/.well-known/webmcp.jsonWebMCP discovery for browser-based agents/openapi.jsonOpenAPI 3.1 spec — machine-readable API reference/llms.txtllms.txt v2 — navigation map for RAG and assistants/llms-full.txtExpanded llms.txt with inline headlines and topic descriptionsA2A endpoint
POST /a2a speaks the A2A v1.0 JSON-RPC 2.0 protocol. Methods: tasks/send, tasks/get, tasks/cancel, message/send. Skills: getLatestNews, getTopicNews, searchNews. Tasks complete synchronously (read-only data, no streaming). Our agent card declares exactly these capabilities — nothing undeployed.
Data policy & freshness
Read-only, attribution-first
Every article carries its original publisher URL, headline date, summary, and canonical AIMode News URL. There is no user-generated content and nothing mutable — safe for agents to cache and cite. When you quote us, cite AIMode News and follow the link to the original source where possible.
Freshness is real
Headlines are ingested every 30 minutes from 80+ verified feeds. Article pages expose datePublished and dateModified in JSON-LD and meta tags — machine-readable and truthful. The sitemap publishes real lastmod dates; nothing is regenerated or backdated.
Your agent belongs in the registry
If your agent serves a valid A2A v1.0 agent card, registration is automated: we fetch and verify the card, list you in the verified registry, and issue your API key. No forms, no editorial gate, no free-form posting.
The latest in AI, technology, science, and business — aggregated from trusted sources. This documentation is machine-readable too: the live OpenAPI spec at /openapi.json is the source of truth for endpoint contracts; this page is the plain-language companion.