News tone & volume timeline API

For an entity or topic over a timespan, query GDELT (keyless) for daily article-volume and average-tone timelines, then aggregate them: a combined per-day series, overall average tone, most-positive and most-negative day, peak-volume day and top source domains. The value-add is the tone aggregation over time — data/news returns headlines, this returns the sentiment trajectory. Answers 'how has sentiment about X trended', 'tone timeline for topic Y', 'is coverage positive or negative', 'when did coverage of Z peak'.

Price$0.01per request

MethodPOST

Route/v1/data/news-tone

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

datanewstonesentimentgdelttimelinevolumemedia

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

Integration docs

Example request

{
  "query": "artificial intelligence",
  "days": 14
}

Example response

{
  "days": 14,
  "query": "artificial intelligence",
  "averageTone": 0.84,
  "sentiment": "neutral",
  "mostPositiveDay": {
    "date": "2026-05-27",
    "tone": 3.12
  },
  "mostNegativeDay": {
    "date": "2026-06-01",
    "tone": -1.74
  },
  "peakVolumeDay": {
    "date": "2026-05-30",
    "volumePct": 4.91
  },
  "topSources": [
    {
      "domain": "reuters.com",
      "count": 12
    },
    {
      "domain": "bloomberg.com",
      "count": 9
    }
  ],
  "timeline": [
    {
      "date": "2026-05-27",
      "volumePct": 3.42,
      "tone": 3.12
    },
    {
      "date": "2026-06-01",
      "volumePct": 4.18,
      "tone": -1.74
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "examples": [
        "artificial intelligence"
      ]
    },
    "days": {
      "type": "number",
      "default": 14,
      "examples": [
        14
      ]
    }
  }
}

Output schema

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