Api Endpoint

api.agentstools.dev

Recent global news articles from the GDELT Project by topic, country, entity or theme, normalized to title, link-back url, domain, source-country, language and ISO timestamp — plus coverage breakdowns (top source-countries, top domains, languages, count) derived from the same result. One call instead of querying and parsing GDELT yourself.

Open interactive test console

Offering

Provider
api.agentstools.dev
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Web Search Research
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://api.agentstools.dev/gdelt/news
MIME type
application/json
First seen
2026-10-16T01:51:10.599Z
Last seen
Tags
News, geopolitics, world, Events, gdelt, global, Media, Intelligence, osint, coverage, multilingual, Research

Payment pricing

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

Payment option 1
0.008 USDC
Atomic price: 8000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "8000",
    "payTo": "0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493"
  }
]

Observed health

Status
Healthy
Latest latency
362 ms
Average latency
1111 ms
HTTP status
402
Last checked
Reachability
100% over 12 checks

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

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "HEAD",
        "DELETE"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "query": {
          "type": "string",
          "description": "Free-text topic (multi-word phrases are auto-quoted). Optional if a theme/country is given."
        },
        "theme": {
          "type": "string",
          "enum": [
            "protests",
            "terrorism",
            "conflict",
            "war",
            "inflation",
            "sanctions",
            "trade",
            "elections",
            "corruption",
            "cyber",
            "immigration",
            "refugees",
            "climate",
            "disaster",
            "epidemic",
            "energy",
            "economy",
            "diplomacy",
            "coup",
            "unrest"
          ],
          "description": "Curated GDELT GKG theme filter (friendly name mapped to a GKG code)."
        },
        "country": {
          "type": "string",
          "description": "Source-country filter by friendly name (United States, Russia, China, ...); mapped to the GDELT FIPS 10-4 code server-side."
        },
        "lang": {
          "type": "string",
          "description": "Source-language filter by name (english, russian, arabic, ...)."
        },
        "timespan": {
          "type": "string",
          "description": "Lookback window: 15min, 24h, 3d, 1w, 1m (default 24h)."
        },
        "limit": {
          "type": "integer",
          "minimum": 1,
          "maximum": 250,
          "description": "Max articles (default 30, GDELT cap 250)."
        },
        "sort": {
          "type": "string",
          "enum": [
            "datedesc",
            "dateasc",
            "relevance",
            "tonedesc",
            "toneasc"
          ],
          "description": "Result ordering (default datedesc)."
        }
      },
      "required": []
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "input": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "const": "http"
        },
        "method": {
          "type": "string",
          "enum": [
            "GET",
            "HEAD",
            "DELETE"
          ]
        },
        "queryParams": {
          "type": "object",
          "properties": {
            "query": {
              "type": "string",
              "description": "Free-text topic (multi-word phrases are auto-quoted). Optional if a theme/country is given."
            },
            "theme": {
              "type": "string",
              "enum": [
                "protests",
                "terrorism",
                "conflict",
                "war",
                "inflation",
                "sanctions",
                "trade",
                "elections",
                "corruption",
                "cyber",
                "immigration",
                "refugees",
                "climate",
                "disaster",
                "epidemic",
                "energy",
                "economy",
                "diplomacy",
                "coup",
                "unrest"
              ],
              "description": "Curated GDELT GKG theme filter (friendly name mapped to a GKG code)."
            },
            "country": {
              "type": "string",
              "description": "Source-country filter by friendly name (United States, Russia, China, ...); mapped to the GDELT FIPS 10-4 code server-side."
            },
            "lang": {
              "type": "string",
              "description": "Source-language filter by name (english, russian, arabic, ...)."
            },
            "timespan": {
              "type": "string",
              "description": "Lookback window: 15min, 24h, 3d, 1w, 1m (default 24h)."
            },
            "limit": {
              "type": "integer",
              "minimum": 1,
              "maximum": 250,
              "description": "Max articles (default 30, GDELT cap 250)."
            },
            "sort": {
              "type": "string",
              "enum": [
                "datedesc",
                "dateasc",
                "relevance",
                "tonedesc",
                "toneasc"
              ],
              "description": "Result ordering (default datedesc)."
            }
          },
          "required": []
        }
      },
      "required": [
        "type",
        "method"
      ],
      "additionalProperties": false
    },
    "output": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string"
        },
        "example": {
          "type": "object"
        }
      },
      "required": [
        "type"
      ]
    }
  },
  "required": [
    "input"
  ]
}