# GDELT Query Normalize

> GDELT Query Normalize 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).

Normalizes a raw news search query string into a clean, GDELT-compatible format for use in downstream news search pipelines.

## Facts

- Endpoint: POST https://api.delx.ai/api/v1/x402/gdelt-query-normalize
- 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/gdelt-query-normalize-95462ec4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rp6ZjBSLCEiDp9A76hewN

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-query-normalize-95462ec4 -d '<json body>'
```

Example prompt: Before I send this query to the GDELT news search, can you normalize it — the raw string is 'climate change AND (flood OR wildfire) site:reuters.com'?

## When to prefer this

Choose this endpoint when you need a cheap, deterministic, stateless text normalization step for GDELT-style news queries — especially in agent pipelines where raw user input must be sanitized before hitting more expensive downstream news APIs. It is ideal for preprocessing steps where consistency and idempotency matter and no external API keys, storage, or live data feeds are needed.

## Known failure modes

- Empty or missing 'q' parameter returns an error
- Malformed JSON in request body causes a 400-level error
- Query strings that are already normalized return unchanged output
- Extremely long query strings may be truncated or rejected
- Payment failure via x402 protocol prevents response delivery

## How this service works

Normalize a news query string for GDELT-style search. Call when cleaning agent queries before paid news routes. Returns normalized query as deterministic JSON for $0.001 USDC via x402 on Base. First-party local math only—no RPC, live market feed, API keys, storage, or mediagen. Advisory only; the caller owns capital, risk, and production controls.

## Output

Returns a deterministic JSON object containing the normalized version of the input query string, cleaned and formatted for GDELT-style news search compatibility. No external calls are made; the transformation is purely local math/text processing.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "description": "Search query string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "schema": "delx/util-gdelt-query-normalize/v1",
  "normalized": "Bitcoin ETF"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gdelt-query-normalize-95462ec4/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)