Data

Recent news headlines (GDELT) API

Query global news by keyword/topic (optionally filtered by source country or language) via the keyless GDELT DOC API, returning recent headlines normalized into clean objects with title, source domain, canonical URL, ISO 8601 date and numeric tone, plus an average-tone metric. The MORE: GDELT's raw ArtList is messy (compact date strings, string/number tone, domain-only sources) — this parses it into typed headline objects and computes average tone. Answers 'latest news about climate', 'headlines on AI from the US', 'recent articles in French about elections', 'what is the news tone on a topic'.

Price$0.01per request

MethodPOST

Route/v1/data/news

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

datanewsheadlinesgdeltmediaarticlespresscurrent-events

API URLhttps://x402.hexl.dev/v1/data/news

Integration docs

Example request

{
  "query": "climate change",
  "country": "US",
  "limit": 2
}

Example response

{
  "query": "climate change",
  "count": 2,
  "averageTone": -1.3,
  "headlines": [
    {
      "title": "States move to cut emissions",
      "source": "example.com",
      "url": "https://example.com/a",
      "date": "2026-06-01T03:15:00Z",
      "country": "US",
      "language": "English",
      "tone": -1.3
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "examples": [
        "climate change"
      ]
    },
    "country": {
      "type": "string",
      "examples": [
        "US"
      ]
    },
    "language": {
      "type": "string",
      "examples": [
        "english"
      ]
    },
    "limit": {
      "type": "number",
      "examples": [
        15
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}