Geotone API

Every dashboard on this site has a free, read-only JSON twin. Built for AI agents, researchers, and integrations. No key required.

Quick start

curl https://geotone.news/api/v1/topics/ukraine-war

Machine-readable spec: OpenAPI 3.1· MCP server for AI agents: POST https://geotone.news/mcp

Endpoints

`/api/v1/topics`	All tracked topics with current stats
`/api/v1/topics/{slug}` try: /api/v1/topics/ukraine-war	One topic: 90-day series, z-score, WoW change, article sample
`/api/v1/countries`	All countries with current stats
`/api/v1/countries/{iso2}` try: /api/v1/countries/ua	One country: 90-day series and active topics
`/api/v1/trending`	Surging topics (z ≥ 2), biggest movers, surging countries
`/api/v1/relations/{a}-{b}` try: /api/v1/relations/cn-us	Bilateral co-coverage for a monitored pair
`/api/v1/briefings/{date}`	Daily briefings (publishing begins in a later release)

Terms, limits & attribution

License: all derived data is CC BY 4.0. Attribution is required: cite "Geotone / GDELT" with a link to the relevant page (the meta object in every response carries these terms).
Rate limit: 60 uncached requests per minute per IP. Responses are edge-cached for 15 minutes and cached hits don't count — well-behaved clients rarely see a 429. Need more? Email us.
Scope: endpoints mirror site pages one-to-one with 90-day windows. There are deliberately no bulk-export routes. For commercial use, higher limits, bulk historical exports (our archive reaches back to January 2026, extensible to 2015), or bespoke extracts, see custom data.
Article data: headline, source domain, and link only — article text is never stored or served. Headlines remain the property of their publishers.
Stability: the v1 surface is additive-only; fields may be added but not removed or renamed. Breaking changes would ship as /api/v2.

For AI agents

An MCP (Model Context Protocol) server exposes this data as tools — get_trending, get_wire, get_story_chain, get_topic, get_country, get_relation, search_topics, get_briefing — over streamable HTTP at https://geotone.news/mcp, no auth required. Site orientation for LLMs: /llms.txt.