{"uid":"cap_L6bZ1hoIMRSJY9FWrs98j","slug":"bitcoin-news-headlines-search-via-gdelt-1cc034c5","name":"Bitcoin News Headlines Search via GDELT","description":"Interactive Bitcoin 4-year halving cycle chart on a polar disc. Live price, 200W MA, Mayer Multiple, RSI, MACD, Pi Cycle and optional paid cycle projections.","url":"https://4yearcycle.com/x402/news-headlines","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"max":{"type":"string","default":"20","pattern":"^\\d{1,3}$","examples":["20","100"],"description":"Maximum number of headlines to return after deduplication. Integer 1-100; values above 100 are capped. Default: 20."},"lang":{"type":"string","default":"english","examples":["english","german","any"],"description":"Article language filter, GDELT language name (english, german, spanish, ...). Use \"any\" for all 65 languages. Default: english."},"hours":{"type":"string","default":"24","pattern":"^\\d{1,3}$","examples":["24","168"],"description":"Look-back window in hours over article first-seen time. Integer 1-168 (7 days); values above 168 are capped. Default: 24."},"query":{"type":"string","examples":["\"bitcoin regulation\"","(drought OR wildfire) climate","semiconductor domain:reuters.com"],"description":"Required free-text search over article text, GDELT syntax: quote multi-word phrases (\"bitcoin regulation\"), parenthesized OR groups, domain:site.com. Unquoted multi-word input means all words anywhere in the article."},"country":{"type":"string","examples":["germany","unitedstates","US"],"description":"Optional source-country filter on the publishing outlet: GDELT country name without spaces (germany, france, unitedstates) or FIPS 2-letter code (GM, FR, US). Empty = all countries."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["count","articles"],"properties":{"count":{"type":"integer","description":"Number of headlines returned (after deduplication and max cap); 0 = no matches in the window"},"articles":{"type":"array","items":{"type":"object","required":["title","url"],"properties":{"url":{"type":"string","description":"Canonical article URL"},"title":{"type":"string","description":"Article headline as crawled by GDELT, truncated to 300 characters"},"domain":{"type":["string","null"],"description":"Publisher domain, e.g. reuters.com"},"language":{"type":["string","null"],"description":"Article language as detected by GDELT, e.g. English"},"seendate":{"type":["string","null"],"description":"When GDELT first saw the article, ISO 8601 UTC"},"sourcecountry":{"type":["string","null"],"description":"Country of the publishing outlet as classified by GDELT, e.g. Germany"}}},"description":"Matching articles, newest first, deduplicated by domain + title"}}}}}}},"responseSchema":{"type":"json","example":{"count":2,"articles":[{"url":"https://www.finanznachrichten.de/nachrichten-2026-08/69341019-coinshares-plc-coinshares-renames-wgmi-as-bitcoin-mining-and-digital-power-etf-reflecting-the-convergence-of-bitcoin-mining-and-ai-infrastructure-399.htm","title":"CoinShares PLC : CoinShares Renames WGMI as CoinShares Bitcoin Mining and Digital Power ETF , Reflecting the Convergence of Bitcoin Mining and AI Infrastructure","domain":"finanznachrichten.de","language":"English","seendate":"2026-08-18T11:30:00Z","sourcecountry":"Germany"},{"url":"https://www.freepressjournal.in/business/bitcoin-etfs-see-390-million-weekly-outflows-as-investor-sentiment-turns-cautious","title":"Bitcoin ETFs See $390 Million Weekly Outflows As Investor Sentiment Turns Cautious","domain":"freepressjournal.in","language":"English","seendate":"2026-08-17T13:00:00Z","sourcecountry":"India"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hJgxzbcg8vsr9RVKROyQE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches deduplicated, recent news headlines matching a GDELT-powered full-text query, with filters for language, time window, and source country.","exampleAgentPrompt":"Search for the latest English-language news headlines about 'Bitcoin ETF outflows' from the past 48 hours, return up to 30 results.","exampleUseCases":[{"title":"Monitor Bitcoin regulation news","prompt":"Find me the top 20 English news headlines about 'bitcoin regulation' published in the last 24 hours — I want to see what's being reported globally right now."},{"title":"Track Bitcoin sentiment by country","prompt":"Search for recent Bitcoin news from United States sources in the last 72 hours, up to 50 headlines, so I can gauge US media sentiment around the halving cycle."},{"title":"Research Bitcoin mining coverage","prompt":"Get me up to 30 English-language news articles about 'bitcoin mining infrastructure' from the past week — I'm trying to understand how the press is covering the AI and mining convergence story."}],"resultDescription":"A JSON object containing a count of returned articles and an array of deduplicated news article objects, each with URL, title, domain, language, first-seen timestamp, and source country.","failureModes":["Empty result set (count: 0) when no articles match the query within the time window","Query syntax errors if GDELT operators are malformed (e.g. unclosed quotes)","hours or max values above caps (168, 100) are silently capped rather than errored","Invalid country codes or language names return no results rather than an error","Payment failure if USDC balance is insufficient for the $0.01 per-call fee"],"whenToPreferThis":"Choose this endpoint when you need recent, deduplicated news headlines searchable by full-text GDELT query with language and country filters, especially for Bitcoin or crypto topics. Prefer it over generic web search when you want structured article metadata (URL, domain, language, country, timestamp) rather than ranked snippets, and when you need to filter by publication recency (up to 7 days) or source country.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:37:58.434Z","isFirstParty":false}