{"uid":"cap_WZTLQvcGChBFHIw-5y7NS","slug":"x402-news-headlines-search-gdelt-72h-daaf43ae","name":"x402 News Headlines Search (GDELT, 72h)","description":"Use when you need news articles or headlines from the last 72 hours about a topic, company or person. Do not use for full article text, paywalled sources, non-English coverage or news older than 72 hours. Returns JSON with recent news articles matching keywords: headline, URL, source, publish time, authors, tone, image and the people and organizations named, from GDELT for 0.008 USDC per call. Typical response time 600 ms (p95). Category: Search.","url":"https://x402-gateway.blackwoodstate8.workers.dev/v1/news-headlines?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["query"],"properties":{"sort":{"enum":["recent","relevance"],"type":"string","description":"recent (default) or relevance"},"hours":{"type":"integer","maximum":72,"minimum":1,"description":"How far back to look, in hours (1-72, 24 when omitted)"},"limit":{"type":"integer","maximum":50,"minimum":1,"description":"Maximum articles to return (1-50, 20 when omitted)"},"query":{"type":"string","maxLength":200,"minLength":2,"description":"Keywords to find in headlines, people and organizations, e.g. nvidia earnings (all words must match)"},"domain":{"type":"string","maxLength":253,"description":"Only articles from this source domain, e.g. reuters.com"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["query","hours","count","articles","lastIngestAt","attribution"],"properties":{"next":{"type":"object","required":["service","tool","method","url","useWhen","sample"],"properties":{"url":{"type":"string","description":"Paid route of the next call"},"tool":{"type":"string","description":"MCP tool name of the same call"},"method":{"enum":["GET","POST"],"type":"string"},"sample":{"type":"string","description":"Free fixed sample of the whole family"},"service":{"type":"string","description":"Service id of the suggested next paid call"},"useWhen":{"type":"string","description":"When the next call is the right one"}},"description":"Suggested next paid call in the same family (call it in a loop when the task continues)","additionalProperties":false},"count":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"hours":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"query":{"type":"string"},"articles":{"type":"array","items":{"type":"object","required":["title","url","domain","publishedAt","authors","tone","image","persons","organizations","themes"],"properties":{"url":{"type":"string"},"tone":{"type":["number","null"]},"image":{"type":["string","null"]},"title":{"type":"string"},"domain":{"type":"string"},"themes":{"type":"array","items":{"type":"string"}},"authors":{"type":["string","null"]},"persons":{"type":"array","items":{"type":"string"}},"publishedAt":{"type":"string"},"organizations":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"attribution":{"type":"string"},"lastIngestAt":{"type":["string","null"]}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"count":1,"hours":24,"query":"climate finance","articles":[{"url":"https://openthemagazine.com/india/india-urges-rich-nations-to-deliver-climate-finance-ahead-of-cop31","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","title":"India Calls on Rich Nations to Fulfill Climate Finance Commitments Ahead of COP31","domain":"openthemagazine.com","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"],"authors":"Open Bureau","persons":["Soumya Nair","Jal Shakti Abhiyan","Surya Ghar"],"publishedAt":"2026-10-17T06:15:00.000Z","organizations":["National Green Hydrogen Mission","International Solar Alliance","United Nations","Counsellor At India Permanent Mission","Global Biofuels Alliance"]}],"attribution":"Source: The GDELT Project (https://www.gdeltproject.org/)","lastIngestAt":"2026-10-17T06:18:11.598Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1LO3gUa4e9aeDbcZyMS1j","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns recent news headlines from the last 72 hours matching a keyword query, sourced from GDELT, with metadata including tone, people, organizations, and images.","exampleAgentPrompt":"Find me the top 20 most recent news headlines mentioning 'Apple earnings' from the last 48 hours, sorted by most recent first.","exampleUseCases":[{"title":"Brand press coverage monitoring","prompt":"Pull the 20 most recent headlines mentioning 'Tesla' from the last 24 hours, sorted by recency, so I can see what the press is saying about them right now."},{"title":"Competitor news intelligence","prompt":"Search for news about 'OpenAI' from the last 72 hours, limit to 30 articles sorted by relevance, and include tone and named organizations so I can track the competitive landscape."},{"title":"Executive reputation check","prompt":"Get me up to 15 recent news articles from the last 48 hours that mention 'Sam Altman', sorted by most recent, so I can see what journalists are writing about him."}],"resultDescription":"A JSON object containing the query, hours window, article count, and an array of articles each with headline, URL, source domain, publish timestamp, authors, sentiment tone score, image URL, named persons, and named organizations. Also includes a lastIngestAt timestamp, GDELT attribution, and a suggested next-call hint.","failureModes":["Query string too short (under 2 chars) or too long (over 200 chars) returns validation error","Hours parameter outside 1-72 range returns validation error","Limit parameter outside 1-50 range returns validation error","No matching articles found returns empty articles array with count 0","Invalid domain filter returns empty results or validation error","Payment failure or insufficient USDC balance returns 402 error","GDELT data lag may mean very recent events (last few minutes) are missing"],"whenToPreferThis":"Use this endpoint when you need recent (within 72 hours), English-language news headlines about a specific keyword, person, company, or topic with structured metadata including sentiment tone and named entities. Prefer this over general web search when you need structured article metadata (tone, people, organizations) from a consistent news corpus. Do not use for full article text, non-English news, paywalled sources, or news older than 72 hours.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T00:53:41.351Z","isFirstParty":false,"canonicalSlug":"x402-news-headlines-search-gdelt-72h-daaf43ae"}