{"slug":"draconic21-x402-api-onrender-com-v1-news-search-81dc67","title":"News Search ($0.009)","host":"draconic21-x402-api.onrender.com","method":"POST","resource":"https://draconic21-x402-api.onrender.com/v1/news_search","category":"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 filter","price_listed":0.009,"price_asked":0.009,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":462,"reported_calls_30d":3,"reported_payers_30d":3,"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"max_records":10,"query":"bitcoin","timespan":"1w"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":true,"properties":{"country":{"description":"GDELT source-country name, single token, e.g. 'unitedstates'. Optional.","type":"string"},"domain":{"description":"Restrict to one publishing domain, e.g. 'nytimes.com'. Optional.","type":"string"},"language":{"description":"GDELT source-language name, single token, e.g. 'english', 'spanish'. Optional.","type":"string"},"max_records":{"description":"articles mode only, 1-50. Default 20.","type":"integer"},"max_tone":{"description":"Only articles with GDELT tone below this value (-100..100). Optional.","type":"number"},"min_tone":{"description":"Only articles with GDELT tone above this value (-100..100). Optional.","type":"number"},"mode":{"description":"Default 'articles' (deduped headline list). 'timeline' returns a volume+avg-tone series instead.","enum":["articles","timeline"],"type":"string"},"query":{"description":"Search query, e.g. 'bitcoin etf'. Required.","type":"string"},"sort":{"description":"articles mode only. Default 'date'.","enum":["date","relevance"],"type":"string"},"timespan":{"description":"Lookback window. Default '1d'.","enum":["1h","6h","12h","1d","2d","3d","1w","2w","1m","3m"],"type":"string"}},"required":[],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"properties":{"article_count":{"type":"integer"},"articles":{"items":{"properties":{"domain":{"type":"string"},"image":{"type":["string","null"]},"language":{"type":"string"},"seen_at":{"format":"date-time","type":["string","null"]},"source_country":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"}},"type":"object"},"type":"array"},"caveats":{"items":{"type":"string"},"type":"array"},"mode":{"enum":["articles","timeline"],"type":"string"},"points":{"items":{"properties":{"avg_tone":{"type":["number","null"]},"date":{"type":"string"},"volume_pct":{"type":["number","null"]}},"type":"object"},"type":"array"}},"required":["mode","caveats"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-10","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.009,"price_match":true,"latency_ms":462,"error":null}],"description_full":"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…","last_updated":"2026-10-08T23:58:03.198Z","schemes":["exact"]}