# GDELT News Search

> GDELT News Search is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-14).

Fetches recent global news articles from the GDELT Project filtered by topic, country, entity, or theme, returning normalized article metadata and coverage breakdowns in one call.

## Facts

- Endpoint: GET https://payai.agentstools.dev/gdelt/news
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gdelt-news-search-49e482cd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_07PHVFaH9RjBCYMvqg7nP

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-search-49e482cd
```

Example prompt: Can you pull the top 50 most recent GDELT news articles about the Ukraine conflict from the past week, filtered to English-language sources, and give me a breakdown of which countries and domains are covering it most?

## When to prefer this

Use this endpoint when you need current global news articles from GDELT without writing raw GDELT API queries or parsing GKG theme codes yourself. It is ideal when you want normalized, structured article metadata plus source-coverage analytics (top countries, domains, language breakdown) in a single call. Prefer it over raw GDELT access when you need friendly theme names (elections, climate, sanctions), country names mapped automatically, and aggregated coverage stats returned together with articles.

## Known failure modes

- Invalid country name not mappable to GDELT FIPS code returns an error or empty result
- Timespan value outside supported options (15min, 24h, 3d, 1w, 1m) causes a validation error
- Limit exceeding 250 is rejected by GDELT cap
- Query and theme both omitted may return broad or unexpected results
- GDELT upstream unavailability causes service errors
- Very niche queries may return zero articles within the requested timespan

## How this service works

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.

## Output

Returns a list of normalized news articles (title, URL, domain, source country, language, ISO timestamp) plus aggregate coverage breakdowns including top source countries, top domains, language distribution, and total article count — all derived from a single GDELT query.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "lang": {
       "type": "string",
       "description": "Source-language filter by name (english, russian, arabic, ...)."
      },
      "sort": {
       "enum": [
        "datedesc",
        "dateasc",
        "relevance",
        "tonedesc",
        "toneasc"
       ],
       "type": "string",
       "description": "Result ordering (default datedesc)."
      },
      "limit": {
       "type": "integer",
       "maximum": 250,
       "minimum": 1,
       "description": "Max articles (default 30, GDELT cap 250)."
      },
      "query": {
       "type": "string",
       "description": "Free-text topic (multi-word phrases are auto-quoted). Optional if a theme/country is given."
      },
      "theme": {
       "enum": [
        "protests",
        "terrorism",
        "conflict",
        "war",
        "inflation",
        "sanctions",
        "trade",
        "elections",
        "corruption",
        "cyber",
        "immigration",
        "refugees",
        "climate",
        "disaster",
        "epidemic",
        "energy",
        "economy",
        "diplomacy",
        "coup",
        "unrest"
       ],
       "type": "string",
       "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."
      },
      "timespan": {
       "type": "string",
       "description": "Lookback window: 15min, 24h, 3d, 1w, 1m (default 24h)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gdelt-news-search-49e482cd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)