# GDELT News Attention & Tone Timeline

> GDELT News Attention & Tone Timeline is a paid API for AI agents from gdelt.use.x402atlas.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns a merged coverage-volume and average-tone time series for any GDELT query, showing how news attention and sentiment shift over time.

## Facts

- Endpoint: GET https://gdelt.use.x402atlas.com/timeline
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gdelt-news-attention-tone-timeline-e8d352df
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_65IVMzInHVQzFkMd7I7Sr

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gdelt-news-attention-tone-timeline-e8d352df
```

Example prompt: Can you pull the GDELT news attention and tone timeline for 'Ukraine war' over the past 3 months, using a 7-day moving average smoothing window?

## When to prefer this

Use this endpoint when you need to understand how media attention and sentiment around a topic, entity, or event have evolved over time — particularly when you want both volume and tone in a single unified time series. Prefer this over a raw GDELT article search when the goal is trend analysis rather than retrieving individual articles.

## Known failure modes

- Invalid or malformed GDELT query syntax returns an error
- Timespan exceeding 3 months is rejected
- Smoothing window outside 1–30 range returns a validation error
- No results found for an obscure or misspelled query
- Rate limiting or payment failure if x402 payment not processed

## How this service works

News attention & tone timeline by GDELT — coverage-volume and average-tone time series for any query, merged from GDELT's two timeline feeds into one series.

## Output

A merged time series combining two GDELT timeline feeds: one showing coverage volume (how many news articles mention the query) and one showing average tone (positive vs. negative sentiment) at each time point, returned as structured data over the requested timespan.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string",
       "description": "GDELT query syntax (see /gdelt/search)"
      },
      "timespan": {
       "type": "string",
       "default": "3m",
       "pattern": "^[0-9]+(min|h|d|w|m)$",
       "description": "Relative window like 7d, 2w, 3m; capped at 90 days"
      },
      "timelinesmooth": {
       "type": "integer",
       "maximum": 30,
       "minimum": 1,
       "description": "Moving-average window over the series (optional)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "query",
      "queried_at",
      "timespan",
      "series",
      "partial",
      "warnings",
      "attribution"
     ],
     "properties": {
      "note": {
       "type": "string",
       "description": "Present only on a sample response (empty/omitted query): a hint to pass a real query. The paid request ran; no upstream call was made."
      },
      "query": {
       "type": "string",
       "description": "Echo of the request query"
      },
      "series": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "date",
         "volume_pct",
         "tone"
        ],
        "properties": {
         "date": {
          "type": "string",
          "format": "date-time"
         },
         "tone": {
          "type": [
           "number",
           "null"
          ],
          "description": "Average article tone on this date; null if the tone feed had no value here"
         },
         "volume_pct": {
          "type": [
           "number",
           "null"
          ],
          "description": "Share of monitored coverage matching the query on this date; null if the volume feed had no value here"
         }
        }
       }
      },
      "partial": {
       "type": "boolean",
       "description
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "bitcoin",
  "series": [
   {
    "date": "2026-04-01T00:00:00Z",
    "tone": -1.8,
    "volume_pct": 0.42
   }
  ],
  "timespan": "3m",
  "queried_at": "2026-07-01T12:00:00Z",
  "attribution": "Data from The GDELT Project (https://www.gdeltproject.org)"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gdelt-news-attention-tone-timeline-e8d352df/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gdelt.use.x402atlas.com](https://www.zero.xyz/host/gdelt.use.x402atlas.com/llms.txt)