{"uid":"cap_rp6ZjBSLCEiDp9A76hewN","slug":"gdelt-query-normalize-95462ec4","name":"GDELT Query Normalize","description":"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.","url":"https://api.delx.ai/api/v1/x402/gdelt-query-normalize","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"q":{"type":"string","description":"Search query string"}}},"responseSchema":{"type":"json","example":{"schema":"delx/util-gdelt-query-normalize/v1","normalized":"Bitcoin ETF"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_n45M0rMQEESAbaxKW9BPq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Normalizes a raw news search query string into a clean, GDELT-compatible format for use in downstream news search pipelines.","exampleAgentPrompt":"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'?","exampleUseCases":[{"title":"Cleaning agent queries before news lookup","prompt":"I'm about to search GDELT for news about 'US-China trade war tariffs 2024' — can you normalize that query string first so it's properly formatted for GDELT-style search?"},{"title":"Preprocessing multi-term boolean queries","prompt":"I have this complex query with AND/OR operators and some weird characters: 'electric vehicles OR EV AND battery (shortage) site:bloomberg.com' — normalize it for GDELT before I pay for the full news API call."},{"title":"Standardizing queries from user input","prompt":"A user typed 'COVID-19   vaccines   mRNA pfizer!!!' into our news search box — can you clean and normalize that string so it works properly with our GDELT news pipeline?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:53:36.969Z","isFirstParty":false}