Tool detail

GDELT Global News Intelligence

Searches global news articles via GDELT full-text search with phrase, OR, country, theme and tone query syntax.

Categories: News

Use when

search worldwide news coverage of a topic
find recent articles from a specific source country or theme

Not for

not a coverage-volume time series - use the separate timeline endpoint for that

Inputs

GET query params: query (string, required, GDELT syntax); maxrecords (1-250, default 75), sort (enum, default HybridRel), timespan (pattern, default 3d), all optional.

Admitted input schema

{
  "type": "object",
  "properties": {
    "maxrecords": {
      "type": "integer",
      "minimum": 1,
      "maximum": 250,
      "description": "Number of articles to return, capped at 250",
      "default": 75
    },
    "query": {
      "type": "string",
      "minLength": 0,
      "maxLength": 1024,
      "description": "GDELT query syntax — phrases, OR, -exclude, domain:, sourcelang:, sourcecountry:, theme:, tone>/<, near"
    },
    "sort": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "DateDesc",
        "DateAsc",
        "ToneDesc",
        "ToneAsc",
        "HybridRel"
      ],
      "description": "Result ordering",
      "default": "HybridRel"
    },
    "timespan": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "pattern": "^[0-9]+(min|h|d|w|m)$",
      "description": "Relative window like 15min, 1h, 7d, 2w, 3m; capped at 90 days",
      "default": "3d"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Endpoint

Method: GET
URL: https://gdelt.use.x402atlas.com/search

Payment

Protocol: x402
Listed price: 0.005 USDC per call on Base
Payment method: exact
Network: eip155:8453
Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Directory: Coinbase x402 Bazaar
Record: GET https://gdelt.use.x402atlas.com/search
Retrieved: 2026-09-30T20:37:07.382Z
Catalog file SHA-256: 6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built: 2026-09-30T22:31:58.034Z