{"uid":"cap_cL2W-DY-Sai2EtWHaVwex","slug":"d21-news-search-f52df1ec","name":"d21 News Search","description":"News Search ($0.009): multi-language, multi-country news headline search plus an optional volume/tone timeline, built entirely on the GDELT Project's free, keyless DOC 2.0 API (100+ languages, updated every 15min). Body { query } required; optional timespan (1h..3m), language, country, domain filters, min_tone/max_tone, sort (date|relevance), max_records (1-50). Pass mode:\"timeline\" for a per-period volume+tone series instead of an article list. Headlines/URLs/metadata only -- never relays…","url":"https://draconic21-x402-api.onrender.com/v1/news_search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"mode":{"enum":["articles","timeline"],"type":"string","description":"Default 'articles' (deduped headline list). 'timeline' returns a volume+avg-tone series instead."},"sort":{"enum":["date","relevance"],"type":"string","description":"articles mode only. Default 'date'."},"query":{"type":"string","description":"Search query, e.g. 'bitcoin etf'. Required."},"domain":{"type":"string","description":"Restrict to one publishing domain, e.g. 'nytimes.com'. Optional."},"country":{"type":"string","description":"GDELT source-country name, single token, e.g. 'unitedstates'. Optional."},"language":{"type":"string","description":"GDELT source-language name, single token, e.g. 'english', 'spanish'. Optional."},"max_tone":{"type":"number","description":"Only articles with GDELT tone below this value (-100..100). Optional."},"min_tone":{"type":"number","description":"Only articles with GDELT tone above this value (-100..100). Optional."},"timespan":{"enum":["1h","6h","12h","1d","2d","3d","1w","2w","1m","3m"],"type":"string","description":"Lookback window. Default '1d'."},"max_records":{"type":"integer","description":"articles mode only, 1-50. Default 20."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.009","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.009/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.009","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.009","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_htfMdSfVP3IIKI2knNpfw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.009","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches multi-language, multi-country news headlines via GDELT DOC 2.0 API, returning article lists or volume/tone timelines with optional filters for language, country, domain, tone, and timespan.","exampleAgentPrompt":"Search for news articles about 'Fed interest rate decision' from the past week in English, sorted by relevance, and return up to 25 results — also flag anything with a strongly negative tone below -5.","exampleUseCases":[{"title":"Breaking crypto news monitoring","prompt":"Find me the latest news headlines about 'bitcoin ETF' from the last 6 hours, sorted by date, up to 20 articles — I want to see what's being published right now."},{"title":"Sentiment timeline for PR crisis","prompt":"Give me a volume and tone timeline for 'Boeing safety' over the past month — I want to see how coverage intensity and sentiment have shifted week by week."},{"title":"Country-specific political coverage","prompt":"Search for news about 'election fraud' published in Spain in Spanish over the last 3 days, sorted by relevance, and return up to 30 articles."}],"resultDescription":"In 'articles' mode: a deduplicated list of up to 50 news headlines with URLs, publication dates, source domains, country/language metadata, and GDELT tone scores. In 'timeline' mode: a per-period time series showing article volume and average tone for the query, useful for tracking coverage intensity and sentiment shifts over time.","failureModes":["Missing required 'query' field returns a 400 validation error","Invalid timespan enum value returns a 400 error","GDELT upstream outage or delay may cause empty results or timeout","Overly narrow filter combinations (country + language + domain + tone range) may return zero articles","max_records outside 1-50 range returns a validation error","Rare languages or niche domains may have sparse or no GDELT coverage"],"whenToPreferThis":"Choose this endpoint when you need fast, broad, multi-language news search across 100+ countries without requiring API keys or subscriptions, especially when tone/sentiment filtering or volume timelines are needed. Prefer it over general web search when you specifically want news headlines with GDELT metadata including tone scores, source country, and language. Best for monitoring coverage trends, sentiment shifts, or finding international press on a topic updated as frequently as every 15 minutes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:40:19.664Z","isFirstParty":false,"canonicalSlug":"d21-news-search-f52df1ec"}