# Delx Commerce News Search (GDELT)

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

Searches recent news articles via the GDELT Project, returning headlines and URLs matching a query within a configurable time window

## Facts

- Endpoint: POST https://commerce.delx.ai/api/v1/x402/news-search?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/delx-commerce-news-search-gdelt-6e3af306
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_47k2W6QzoaiEgqGvSe4M_

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-commerce-news-search-gdelt-6e3af306 -d '<json body>'
```

Example prompt: Search for the latest news about 'Federal Reserve interest rates' from the past 24 hours, sorted by date, and return up to 10 results.

## When to prefer this

Choose this endpoint when you need fast, pay-per-call access to indexed global news without API key signup, especially in agentic workflows where cost predictability ($0.001 per call) and USDC micropayment settlement on Base or Solana matter. Prefer it over news APIs requiring OAuth or subscriptions when you want verifiable delivery and no ongoing account management.

## Known failure modes

- Empty result set if no news matches the query within the timespan
- Timeout if the GDELT backend exceeds the configured timeout (2–30 seconds)
- Validation error if query is empty or exceeds 200 characters
- Invalid enum value error if sort or timespan parameters don't match allowed values
- Payment failure if USDC balance is insufficient via x402 protocol

## How this service works

Pay-per-result APIs for agents. No signup. Exact price. Verifiable delivery. USDC on Base + Solana via x402.

## Output

Returns a JSON object containing a list of up to 10 news articles, each with a URL, headline, source domain, and publication date. Also includes metadata such as query, sort order, timespan, result count, cache status, and attribution to the GDELT Project.

## 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-commerce-news-search-gdelt-6e3af306/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from commerce.delx.ai](https://www.zero.xyz/host/commerce.delx.ai/llms.txt)