# GDELT News Search

> GDELT News Search is a paid API for AI agents from exchangerebel.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-13).

Search GDELT's global news database for articles matching a query, returning relevant news results

## Facts

- Endpoint: GET https://exchangerebel.com/toll/news/search?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gdelt-news-search-decc4a1f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_D7BKI2XFE4l25x8NPsClv

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-decc4a1f
```

Example prompt: Search GDELT for recent news articles about 'Federal Reserve interest rate decision' and show me the top results including headlines and sources.

## When to prefer this

Choose this endpoint when you need to search across a broad global news corpus, especially for international or geopolitical topics. GDELT indexes news from thousands of sources worldwide in many languages, making it ideal for tracking global media coverage, monitoring event mentions, or researching how topics are covered across different regions. Prefer this over general web search when you specifically need structured news article data with metadata.

## Known failure modes

- Missing or empty query parameter returns an error or empty results
- GDELT upstream API unavailability causes timeout or 503 response
- Query too broad returns an overwhelming or truncated result set
- Payment failure (402) if x402 payment header is missing or insufficient
- Rate limiting if too many requests are made in quick succession

## How this service works

gdelt-search

## Output

Returns a list of news articles from the GDELT global news database matching the search query, typically including article titles, publication sources, URLs, publication dates, and potentially tone/sentiment metadata associated with each article.

## 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"
    }
   }
  },
  "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-decc4a1f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from exchangerebel.com](https://www.zero.xyz/host/exchangerebel.com/llms.txt)