Decision-ready global news intelligence for market and OSINT agents. Clean, cached GDELT data with source diversity, geographic coverage, multilingual perspectives, sentiment trends, and citations. Pay per successful query in USDC on Base via x402.
GDELT is a free, well-known public source — but querying it raw is painful for AI agents. Here's what we add:
| Raw GDELT | This API |
|---|---|
Inconsistent XML / quirky JSON (seendate=20240115T120000Z) | Clean predictable JSON (published_at: "2024-01-15T12:00:00Z") |
7+ raw modes to learn (artlist, timelinetone, pointdata…) | 6 task-oriented endpoints, including a decision-ready market/OSINT brief |
| Multi-step research and repeated source parsing | Parallel aggregation, deduplication, caching, source diversity, risk flags, and citations |
| Transient throttling and opaque failures | Timeouts, retry, short-lived cache, and explicit non-settled upstream errors |
| GEO 2.0 API discontinued — calls fail | Replaced with article-source-country aggregation — works reliably |
| API keys, IP whitelist for scale | x402 — sign once with your wallet, done |
| Endpoint | Description | Price |
|---|---|---|
GET /news/brief | Decision-ready brief for market and OSINT agents | $0.01 |
GET /news/recent | Top 25 recent articles | $0.01 |
GET /news/sentiment | Sentiment timeline | $0.02 |
GET /news/geographic | Geographic hotspots by source country | $0.02 |
GET /news/translingual | Multi-language coverage | $0.03 |
GET /news/entity-graph | Entity knowledge graph | $0.05 |
Each endpoint requires an x402 payment in USDC on Base mainnet. Send a request without payment to receive HTTP 402 with the payment requirements in the PAYMENT-REQUIRED response header. Sign the authorization and retry with the PAYMENT-SIGNATURE header to receive the JSON response.
Settlement is handled by the Coinbase CDP facilitator.