Index onlineMerchant portal
Api Endpoint

GDELT Global News Intelligence

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.

Open interactive test console

Offering

Provider
gdelt.use.x402atlas.com
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Social Intelligence
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://gdelt.use.x402atlas.com/timeline
MIME type
application/json
First seen
2026-10-16T01:50:14.534Z
Last seen
Tags
News, gdelt, timeline, tone, sentiment, volume, trend, Signal

Website

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.02 USDC
Atomic price: 20000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
0.02 USDC
Atomic price: 20000 · Network: eip155:137 · Asset: USDC · Scheme: exact
Payment option 3
0.02 USDC
Atomic price: 20000 · Network: eip155:42161 · Asset: USDC · Scheme: exact
Payment option 4
0.02 USDC
Atomic price: 20000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "20000",
    "payTo": "0x8d64A4834e262d96d1264e8900b5a4F1405b8982"
  },
  {
    "scheme": "exact",
    "network": "eip155:137",
    "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    "amount": "20000",
    "payTo": "0x8d64A4834e262d96d1264e8900b5a4F1405b8982"
  },
  {
    "scheme": "exact",
    "network": "eip155:42161",
    "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "amount": "20000",
    "payTo": "0x8d64A4834e262d96d1264e8900b5a4F1405b8982"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "20000",
    "payTo": "3nXsChcZGke6xebDPmndNMCt8L3yi6xyN4Pd6q5cQrgv"
  }
]

Observed health

Status
Healthy
Latest latency
13 ms
Average latency
38 ms
HTTP status
402
Last checked
Reachability
100% over 11 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "method": {
      "enum": [
        "GET"
      ],
      "type": "string"
    },
    "queryParams": {
      "properties": {
        "query": {
          "description": "GDELT query syntax (see /gdelt/search)",
          "type": "string"
        },
        "timelinesmooth": {
          "description": "Moving-average window over the series (optional)",
          "maximum": 30,
          "minimum": 1,
          "type": "integer"
        },
        "timespan": {
          "default": "3m",
          "description": "Relative window like 7d, 2w, 3m; capped at 90 days",
          "pattern": "^[0-9]+(min|h|d|w|m)$",
          "type": "string"
        }
      },
      "required": [
        "query"
      ],
      "type": "object"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method"
  ],
  "type": "object"
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "query": {
              "description": "GDELT query syntax (see /gdelt/search)",
              "type": "string"
            },
            "timelinesmooth": {
              "description": "Moving-average window over the series (optional)",
              "maximum": 30,
              "minimum": 1,
              "type": "integer"
            },
            "timespan": {
              "default": "3m",
              "description": "Relative window like 7d, 2w, 3m; capped at 90 days",
              "pattern": "^[0-9]+(min|h|d|w|m)$",
              "type": "string"
            }
          },
          "required": [
            "query"
          ],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "attribution": {
              "description": "Mandatory GDELT licence credit line",
              "type": "string"
            },
            "note": {
              "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.",
              "type": "string"
            },
            "partial": {
              "description": "True when one feed (volume or tone) was unavailable and its metric is null on every point — distinguishes a degraded answer from genuinely missing data",
              "type": "boolean"
            },
            "queried_at": {
              "format": "date-time",
              "type": "string"
            },
            "query": {
              "description": "Echo of the request query",
              "type": "string"
            },
            "series": {
              "items": {
                "properties": {
                  "date": {
                    "format": "date-time",
                    "type": "string"
                  },
                  "tone": {
                    "description": "Average article tone on this date; null if the tone feed had no value here",
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "volume_pct": {
                    "description": "Share of monitored coverage matching the query on this date; null if the volume feed had no value here",
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                },
                "required": [
                  "date",
                  "volume_pct",
                  "tone"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "timespan": {
              "description": "Echo of the effective timespan",
              "type": "string"
            },
            "warnings": {
              "description": "Human-readable notes on any degraded feed, e.g. \"tone feed unavailable\"; empty when the answer is complete",
              "items": {
                "type": "string"
              },
              "type": "array"
            }
          },
          "required": [
            "query",
            "queried_at",
            "timespan",
            "series",
            "partial",
            "warnings",
            "attribution"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}