{"service":"news-headlines","version":"1.0.0","title":"News headlines search","description":"Returns JSON with recent news articles matching keywords: headline, URL, source, publish time, authors, tone, image and the people and organizations named, from GDELT. Use when you need news articles or headlines from the last 72 hours about a topic, company or person. Do not use when you need full article text, paywalled sources, non-English coverage or news older than 72 hours. Price: 0.008 USDC per call. Typical response time: 600 ms (p95).","paid":{"method":"POST","url":"https://x402-gateway.blackwoodstate8.workers.dev/v1/news-headlines","scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"8000","amountUsdc":"0.008","payTo":"0xEFaC6c49a7364e6D25875C0A76e4182F03Dc3f58","maxTimeoutSeconds":60},"input":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":2,"maxLength":200,"description":"Keywords to find in headlines, people and organizations, e.g. nvidia earnings (all words must match)"},"hours":{"description":"How far back to look, in hours (1-72, 24 when omitted)","type":"integer","minimum":1,"maximum":72},"domain":{"description":"Only articles from this source domain, e.g. reuters.com","type":"string","maxLength":253},"limit":{"description":"Maximum articles to return (1-50, 20 when omitted)","type":"integer","minimum":1,"maximum":50},"sort":{"description":"recent (default) or relevance","type":"string","enum":["recent","relevance"]}},"required":["query"]},"example":{"query":"climate finance","limit":3}},"output":{"schema":{"type":"object","properties":{"query":{"type":"string"},"hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"articles":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"},"domain":{"type":"string"},"publishedAt":{"type":"string"},"authors":{"type":["string","null"]},"tone":{"type":["number","null"]},"image":{"type":["string","null"]},"persons":{"type":"array","items":{"type":"string"}},"organizations":{"type":"array","items":{"type":"string"}},"themes":{"type":"array","items":{"type":"string"}}},"required":["title","url","domain","publishedAt","authors","tone","image","persons","organizations","themes"],"additionalProperties":false}},"lastIngestAt":{"type":["string","null"]},"attribution":{"type":"string"}},"required":["query","hours","count","articles","lastIngestAt","attribution"],"additionalProperties":false},"example":{"query":"climate finance","hours":24,"count":1,"articles":[{"title":"India Calls on Rich Nations to Fulfill Climate Finance Commitments Ahead of COP31","url":"https://openthemagazine.com/india/india-urges-rich-nations-to-deliver-climate-finance-ahead-of-cop31","domain":"openthemagazine.com","publishedAt":"2026-10-17T06:15:00.000Z","authors":"Open Bureau","tone":2.65,"image":"https://media.openthemagazine.com/openthemagazine/2026-10-17/d23k6yzu/CLIMATE.jpg?&ar=40:21&auto=format,compress&ogImage=true&mode=crop&enlarge=true&overlay=false&overlay_position=bottom&overlay_width=100","persons":["Soumya Nair","Jal Shakti Abhiyan","Surya Ghar"],"organizations":["National Green Hydrogen Mission","International Solar Alliance","United Nations","Counsellor At India Permanent Mission","Global Biofuels Alliance"],"themes":["ALLIANCE","CONSTITUTIONAL","LEADER","TAX_FNCACT_PRESIDENT","USPEC_POLITICS_GENERAL1","WB_1458_HEALTH_PROMOTION_AND_DISEASE_PREVENTION","WB_1462_WATER_SANITATION_AND_HYGIENE","WB_635_PUBLIC_HEALTH"]}],"lastIngestAt":"2026-10-17T06:18:11.598Z","attribution":"Source: The GDELT Project (https://www.gdeltproject.org/)"}},"mcp":{"url":"https://x402-gateway.blackwoodstate8.workers.dev/mcp","tool":"news-headlines_v1"},"openapi":"https://x402-gateway.blackwoodstate8.workers.dev/openapi.json"}