{"openapi":"3.1.0","info":{"title":"GDELT News Intelligence API","version":"1.0.0","description":"AI-friendly JSON API for global news intelligence. Built on GDELT (free public source), optimized for agents. Adds: clean structured responses instead of GDELT's XML/quirky JSON; 5 use-case endpoints instead of GDELT's 7+ raw modes; parallel-aggregated entity graphs; no 1-req/5-sec rate limit; no API keys. Pay-per-query in USDC on Base mainnet via x402 — requests without payment return HTTP 402 with payment requirements in the PAYMENT-REQUIRED header."},"servers":[{"url":"https://news-x402.com","description":"Production"}],"paths":{"/news/recent":{"get":{"operationId":"recentNews","summary":"Top 25 recent articles for a topic","x402":true,"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"accepts":[{"chain":8453,"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xda8a384c99832de7f176a6c21720227ac024e364"}]},"parameters":[{"name":"topic","in":"query","required":true,"schema":{"type":"string"},"description":"Search query"},{"name":"language","in":"query","schema":{"type":"string","default":"english"},"description":"Source language filter"},{"name":"hours","in":"query","schema":{"type":"integer","minimum":1,"maximum":72,"default":24},"description":"Lookback window in hours (max 72)"}],"responses":{"200":{"description":"Cleaned array of news articles","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required — see PAYMENT-REQUIRED header for x402 details"}}}},"/news/sentiment":{"get":{"operationId":"sentimentTrajectory","summary":"Sentiment trajectory over time for a topic","x402":true,"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"accepts":[{"chain":8453,"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xda8a384c99832de7f176a6c21720227ac024e364"}]},"parameters":[{"name":"topic","in":"query","required":true,"schema":{"type":"string"}},{"name":"country","in":"query","schema":{"type":"string"},"description":"ISO country code filter"},{"name":"timespan","in":"query","schema":{"type":"string","enum":["15min","1h","4h","24h","3d","7d","1w","1m","3m"],"default":"24h"}}],"responses":{"200":{"description":"Sentiment timeseries (GDELT tone score)"},"402":{"description":"Payment required"}}}},"/news/geographic":{"get":{"operationId":"geographicDistribution","summary":"Top source countries reporting on a topic","x402":true,"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"accepts":[{"chain":8453,"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xda8a384c99832de7f176a6c21720227ac024e364"}]},"parameters":[{"name":"topic","in":"query","required":true,"schema":{"type":"string"}},{"name":"timespan","in":"query","schema":{"type":"string","default":"24h"}}],"responses":{"200":{"description":"Source countries with coordinates and mention counts"},"402":{"description":"Payment required"}}}},"/news/translingual":{"get":{"operationId":"translingualCoverage","summary":"Topic coverage across 65 source languages","x402":true,"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"accepts":[{"chain":8453,"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xda8a384c99832de7f176a6c21720227ac024e364"}]},"parameters":[{"name":"topic","in":"query","required":true,"schema":{"type":"string"}},{"name":"hours","in":"query","schema":{"type":"integer","minimum":1,"maximum":72,"default":24}}],"responses":{"200":{"description":"Articles grouped by source language"},"402":{"description":"Payment required"}}}},"/news/entity-graph":{"get":{"operationId":"entityGraph","summary":"Knowledge graph for an entity (sentiment, locations, top sources)","x402":true,"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"accepts":[{"chain":8453,"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xda8a384c99832de7f176a6c21720227ac024e364"}]},"parameters":[{"name":"entity","in":"query","required":true,"schema":{"type":"string"},"description":"Person, organization, or location name"},{"name":"timespan","in":"query","schema":{"type":"string","default":"7d"}}],"responses":{"200":{"description":"Entity knowledge graph: sentiment trend, top locations, top source domains"},"402":{"description":"Payment required"}}}}},"x-discovery":{"ownershipProofs":["0xda8a384c99832de7f176a6c21720227ac024e364"]}}