get_trending

What's surging in global news right now: topics whose coverage is ≥2 standard deviations above their trailing average (z-score), the biggest week-over-week movers, and surging countries. Derived every 2 hours from GDELT across 65+ languages.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_topic

Live media-coverage statistics for one geopolitical topic (e.g. 'ukraine-war', 'taiwan-strait', 'sanctions'): 90-day daily volume and tone series, z-score, week-over-week change, and a sample of recent articles (headline+link only). Use search_topics to find slugs.

Parameters1

slug

string

required

Topic slug, e.g. 'ukraine-war'

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Topic slug, e.g. 'ukraine-war'"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

get_country

Live media-coverage statistics for one country by ISO-3166 alpha-2 code (e.g. 'ua', 'cn'): 90-day daily series of coverage volume (share of world news coverage that is about that country) and tone.

Parameters1

iso2

string

required

ISO2 code, e.g. 'ua'

Raw schema

{
  "type": "object",
  "properties": {
    "iso2": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "description": "ISO2 code, e.g. 'ua'"
    }
  },
  "required": [
    "iso2"
  ],
  "additionalProperties": false
}

get_relation

Bilateral co-coverage signal for a monitored country pair (e.g. a='cn', b='us'): how much the world's press mentions the two countries together, and in what tone. ~50 strategic pairs are monitored.

Parameters2

a	string	required	First country ISO2
b	string	required	Second country ISO2

Raw schema

{
  "type": "object",
  "properties": {
    "a": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "description": "First country ISO2"
    },
    "b": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "description": "Second country ISO2"
    }
  },
  "required": [
    "a",
    "b"
  ],
  "additionalProperties": false
}

search_topics

Search Geotone's tracked geopolitical topics by keyword (matches name, slug, and description). Returns slugs usable with get_topic, plus each topic's current coverage stats.

Parameters1

query

string

required

Keyword, e.g. 'nuclear' or 'china'

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Keyword, e.g. 'nuclear' or 'china'"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

get_briefing

Geotone's daily global risk briefing for a date (YYYY-MM-DD): an analytical summary of coverage surges, tone shifts, and notable movers, with the statistics behind each claim.

Parameters1

date

string

required

UTC date, e.g. 2026-07-02

Raw schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "UTC date, e.g. 2026-07-02"
    }
  },
  "required": [
    "date"
  ],
  "additionalProperties": false
}

get_wire

The live wire: the world's most significant stories right now, ranked by a published formula (authority-weighted outlet breadth, boosted by consequence themes, coded events, and casualty figures, decayed by recency over 72h). Each story carries one representative link, outlet count, tone, countries, and a chain_id when it belongs to a multi-day story timeline (fetch with get_story_chain). Reclustered every 2 hours.

Parameters1

limit

number

optional

Max stories to return (default 20)

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 36,
      "description": "Max stories to return (default 20)"
    }
  },
  "additionalProperties": false
}

get_story_chain

A story timeline: the threaded developments of one multi-day event chain, oldest first (e.g. attack → casualties confirmed → international reaction). Use the chain_id values returned by get_wire. Each development is a headline + link + outlet count + tone.

Parameters1

chain_id

number

required

Chain id from get_wire

Raw schema

{
  "type": "object",
  "properties": {
    "chain_id": {
      "type": "number",
      "description": "Chain id from get_wire"
    }
  },
  "required": [
    "chain_id"
  ],
  "additionalProperties": false
}

Geotone — Global News Signals

get_trending

get_topic

get_country

get_relation

search_topics

get_briefing

get_wire

get_story_chain

Install

Remote endpoint