# Delx GDELT News Search

> Delx GDELT News Search is a paid API for AI agents from api.delx.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Search recent GDELT Project news metadata and return attributed publisher headline links for a given query and timespan.

## Facts

- Endpoint: POST https://api.delx.ai/api/v1/x402/news-search
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/delx-gdelt-news-search-32758b69
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RksKnUM6okgtHO5VFDhoe

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 delx-gdelt-news-search-32758b69 -d '<json body>'
```

Example prompt: Search for the latest news about the US Federal Reserve interest rate decision from the past 3 days, return up to 10 results sorted by date, and give me the publisher links.

## When to prefer this

Choose this endpoint when you need fast, attributed news headline retrieval backed by the GDELT Project's global media monitoring corpus, especially when you need publisher provenance and want bounded metadata (not full article scraping). Prefer it over web search endpoints when the task is specifically news discovery with source attribution, and over generic web crawlers when you need structured headline records rather than raw page content. It is ideal for low-cost, high-frequency news monitoring at $0.001 USDC per call.

## Known failure modes

- Query too short or empty returns a validation error
- Timespan or sort enum value not in allowed list returns a bad request error
- Timeout exceeded (max 8s) if GDELT upstream is slow returns a timeout error
- No results found for an obscure or misspelled query returns an empty result set
- Network or upstream GDELT outage returns a service unavailable error

## How this service works

News search API with publisher links for agents: search recent GDELT Project news metadata for $0.001 USDC. Returns attributed publisher links and bounded headline metadata—never article bodies or arbitrary URL fetches.

## Output

A list of up to 10 news article records from the GDELT Project, each containing a headline, attributed publisher name, publication URL, and timestamp — no full article bodies, just bounded headline metadata with direct publisher links.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "enum": [
    "datedesc",
    "rel",
    "hybridrel"
   ],
   "type": "string",
   "default": "datedesc"
  },
  "query": {
   "type": "string",
   "maxLength": 200,
   "minLength": 1
  },
  "timeout": {
   "type": "integer",
   "default": 25,
   "maximum": 30,
   "minimum": 2
  },
  "timespan": {
   "enum": [
    "1h",
    "3h",
    "6h",
    "12h",
    "1d",
    "3d",
    "7d",
    "30d"
   ],
   "type": "string",
   "default": "1d"
  },
  "max_records": {
   "type": "integer",
   "default": 10,
   "maximum": 10,
   "minimum": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "sort": "datedesc",
   "cache": "miss",
   "count": 1,
   "query": "artificial intelligence",
   "schema": "delx/news-search/v1",
   "articles": [
    {
     "url": "https://example.com/story",
     "title": "Example headline",
     "domain": "example.com",
     "seendate": "20260801T120000Z"
    }
   ],
   "provider": "GDELT Project",
   "timespan": "1d",
   "attribution": "News metadata supplied by the GDELT Project; article rights remain with each publisher.",
   "max_records": 3,
   "provider_url": "https://www.gdeltproject.org/"
  },
  "tool_name": "search_news_gdelt"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/delx-gdelt-news-search-32758b69/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.delx.ai](https://www.zero.xyz/host/api.delx.ai/llms.txt)