AI-friendly JSON API for global news intelligence. Built on GDELT (free public source), optimized for AI agents — clean responses, 5 use-case endpoints, parallel-aggregated entity graphs, no rate limits, no API keys. Pay-per-query in USDC on Base mainnet 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…) | 5 use-case endpoints (recent / sentiment / geographic / translingual / entity-graph) |
| Multi-step queries (3+ calls to build an entity graph) | One call to /news/entity-graph — parallel-aggregated server-side |
| 1 request per 5 seconds rate limit per IP | No rate limit (Cloudflare Workers absorbs it) |
| 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/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 EIP-3009 USDC authorization, send it back as the X-PAYMENT header, and you receive the JSON response.
Settlement is handled by the Coinbase CDP facilitator.