{"slug":"x402stock-xyz-api-v1-news-sentiment-d633ec","title":"Global news attention and tone for any company, ticker, or topic, from the GDELT","host":"x402stock.xyz","method":"GET","resource":"https://x402stock.xyz/api/v1/news-sentiment","category":"company","description":"Global news attention and tone for any company, ticker, or topic, from the GDELT Project's worldwide news monitoring. Pass `?q=Nvidia` (required), `?timespan=1d|3d|1w|2w|1m|3m` (default 1w). Returns average and latest tone with a positive/neutral/negative label and trend, an article-volume timeline,","price_listed":0.02,"price_asked":0.02,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":297,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"q":"Nvidia","timespan":"1w"},"type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":{},"properties":{"q":{"maxLength":120,"minLength":2,"type":"string"},"timespan":{"default":"1w","enum":["1d","3d","1w","2w","1m","3m"],"type":"string"}},"required":["timespan"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"as_of":{"type":"string"},"attribution":{"type":"string"},"query":{"type":"string"},"recent_articles":{"items":{"additionalProperties":false,"properties":{"domain":{"anyOf":[{"type":"string"},{"type":"null"}]},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"seen":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_country":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["title","url","domain","source_country","language","seen"],"type":"object"},"type":"array"},"sentiment":{"additionalProperties":false,"properties":{"average_tone":{"anyOf":[{"type":"number"},{"type":"null"}]},"label":{"type":"string"},"latest_tone":{"anyOf":[{"type":"number"},{"type":"null"}]},"scale":{"type":"string"},"trend":{"type":"string"}},"required":["latest_tone","average_tone","label","trend","scale"],"type":"object"},"source":{"const":"x402stock","type":"string"},"timespan":{"type":"string"},"tone_timeline":{"items":{"additionalProperties":false,"properties":{"date":{"anyOf":[{"type":"string"},{"type":"null"}]},"tone":{"type":"number"}},"required":["date","tone"],"type":"object"},"type":"array"},"venue":{"const":"gdelt","type":"string"},"volume":{"additionalProperties":false,"properties":{"points":{"type":"number"},"total_articles":{"type":"number"}},"required":["total_articles","points"],"type":"object"},"volume_timeline":{"items":{"additionalProperties":false,"properties":{"articles":{"type":"number"},"date":{"anyOf":[{"type":"string"},{"type":"null"}]},"total_monitored":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["date","articles","total_monitored"],"type":"object"},"type":"array"}},"required":["source","venue","as_of","query","timespan","sentiment","volume","tone_timeline","volume_timeline","recent_articles","attribution"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.02,"price_match":true,"latency_ms":297,"error":null}],"description_full":"Global news attention and tone for any company, ticker, or topic, from the GDELT Project's worldwide news monitoring. Pass `?q=Nvidia` (required), `?timespan=1d|3d|1w|2w|1m|3m` (default 1w). Returns average and latest tone with a positive/neutral/negative label and trend, an article-volume timeline, and recent headlines. A media-sentiment read distinct from the Reddit/4chan feeds. From x402stock","last_updated":"2026-09-14T19:11:13.98Z","schemes":["exact"]}