{"uid":"cap_eRAE8zbARR1jPv9LjWxN4","slug":"x402stock-news-sentiment-api-6abeacbb","name":"x402stock News Sentiment API","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, and recent headlines. A media-sentiment read distinct from the Reddit/4chan feeds. From x402stock","url":"https://x402stock.xyz/api/v1/news-sentiment","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["timespan"],"properties":{"q":{"type":"string","maxLength":120,"minLength":2},"timespan":{"enum":["1d","3d","1w","2w","1m","3m"],"type":"string","default":"1w"}},"additionalProperties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["source","venue","as_of","query","timespan","sentiment","volume","tone_timeline","volume_timeline","recent_articles","attribution"],"properties":{"as_of":{"type":"string"},"query":{"type":"string"},"venue":{"type":"string","const":"gdelt"},"source":{"type":"string","const":"x402stock"},"volume":{"type":"object","required":["total_articles","points"],"properties":{"points":{"type":"number"},"total_articles":{"type":"number"}},"additionalProperties":false},"timespan":{"type":"string"},"sentiment":{"type":"object","required":["latest_tone","average_tone","label","trend","scale"],"properties":{"label":{"type":"string"},"scale":{"type":"string"},"trend":{"type":"string"},"latest_tone":{"anyOf":[{"type":"number"},{"type":"null"}]},"average_tone":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},"attribution":{"type":"string"},"tone_timeline":{"type":"array","items":{"type":"object","required":["date","tone"],"properties":{"date":{"anyOf":[{"type":"string"},{"type":"null"}]},"tone":{"type":"number"}},"additionalProperties":false}},"recent_articles":{"type":"array","items":{"type":"object","required":["title","url","domain","source_country","language","seen"],"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"seen":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"domain":{"anyOf":[{"type":"string"},{"type":"null"}]},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_country":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false}},"volume_timeline":{"type":"array","items":{"type":"object","required":["date","articles","total_monitored"],"properties":{"date":{"anyOf":[{"type":"string"},{"type":"null"}]},"articles":{"type":"number"},"total_monitored":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"as_of":"2026-06-06T02:40:00.000Z","query":"Nvidia","venue":"gdelt","source":"x402stock","volume":{"points":167,"total_articles":2841},"timespan":"1w","sentiment":{"label":"neutral","scale":"GDELT average tone, roughly -10 (very negative) to +10 (very positive); 0 is neutral.","trend":"improving","latest_tone":0.42,"average_tone":0.31},"attribution":"Source: The GDELT Project (https://www.gdeltproject.org/)","tone_timeline":[{"date":"2026-06-06T00:00:00Z","tone":-0.198},{"date":"2026-06-06T01:00:00Z","tone":0.755},{"date":"2026-06-06T02:00:00Z","tone":0.42}],"recent_articles":[{"url":"https://www.techtimes.com/articles/317846/20260605/nvidia-not-only-ai-chip-winner-broadcom.htm","seen":"2026-06-06T02:15:00Z","title":"NVIDIA Is Not the Only AI Chip Winner: Broadcom Forecasts $56 Billion","domain":"techtimes.com","language":"English","source_country":"United States"}],"volume_timeline":[{"date":"2026-06-06T01:00:00Z","articles":21,"total_monitored":3104},{"date":"2026-06-06T02:00:00Z","articles":17,"total_monitored":3179}]}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"q":"artificial intelligence","timespan":"1w"}}},"response":{"as_of":"2026-06-12T04:57:44.481Z","query":"artificial intelligence","venue":"gdelt","source":"x402stock","volume":{"points":0,"total_articles":0},"timespan":"1w","sentiment":{"label":"neutral","scale":"GDELT average tone, roughly -10 (very negative) to +10 (very positive); 0 is neutral.","trend":"stable","latest_tone":0.966,"average_tone":0.314},"attribution":"Source: The GDELT Project (https://www.gdeltproject.org/)","tone_timeline":[{"date":"2026-06-05T05:00:00Z","tone":0.085},{"date":"2026-06-05T06:00:00Z","tone":0.259},{"date":"2026-06-05T07:00:00Z","tone":0.379},{"date":"2026-06-05T08:00:00Z","tone":0.231},{"date":"2026-06-05T09:00:00Z","tone":0.57},{"date":"2026-06-05T10:00:00Z","tone":0.563},{"date":"2026-06-05T11:00:00Z","tone":0.472},{"date":"2026-06-05T12:00:00Z","tone":0.565},{"date":"2026-06-05T13:00:00Z","tone":0.287},{"date":"2026-06-05T14:00:00Z","tone":0.297},{"date":"2026-06-05T15:00:00Z","tone":0.634},{"date":"2026-06-05T16:00:00Z","tone":0.128},{"date":"2026-06-05T17:00:00Z","tone":0.042},{"date":"2026-06-05T18:00:00Z","tone":0.506},{"date":"2026-06-05T19:00:00Z","tone":0.514},{"date":"2026-06-05T20:00:00Z","tone":0.429},{"date":"2026-06-05T21:00:00Z","tone":-0.077},{"date":"2026-06-05T22:00:00Z","tone":-0.35},{"date":"2026-06-05T23:00:00Z","tone":-0.368},{"date":"2026-06-06T00:00:00Z","tone":-0.306},{"date":"2026-06-06T01:00:00Z","tone":-0.408},{"date":"2026-06-06T02:00:00Z","tone":0.076},{"date":"2026-06-06T03:00:00Z","tone":-0.068},{"date":"2026-06-06T04:00:00Z","tone":-0.383},{"date":"2026-06-06T05:00:00Z","tone":0.099},{"date":"2026-06-06T06:00:00Z","tone":0.429},{"date":"2026-06-06T07:00:00Z","tone":0.262},{"date":"2026-06-06T08:00:00Z","tone":0.236},{"date":"2026-06-06T09:00:00Z","tone":0.157},{"date":"2026-06-06T10:00:00Z","tone":-0.865},{"date":"2026-06-06T11:00:00Z","tone":0.169},{"date":"2026-06-06T12:00:00Z","tone":0.329},{"date":"2026-06-06T13:00:00Z","tone":0.167},{"date":"2026-06-06T14:00:00Z","tone":0.886},{"date":"2026-06-06T15:00:00Z","tone":0.657},{"date":"2026-06-06T16:00:00Z","tone":0.329},{"date":"2026-06-06T17:00:00Z","tone":0.12},{"date":"2026-06-06T18:00:00Z","tone":0.855},{"date":"2026-06-06T19:00:00Z","tone":0.389},{"date":"2026-06-06T20:00:00Z","tone":0.794},{"date":"2026-06-06T22:00:00Z","tone":0.567},{"date":"2026-06-06T23:00:00Z","tone":0.784},{"date":"2026-06-07T01:00:00Z","tone":1.028},{"date":"2026-06-07T02:00:00Z","tone":-0.299},{"date":"2026-06-07T03:00:00Z","tone":0.684},{"date":"2026-06-07T04:00:00Z","tone":0.244},{"date":"2026-06-07T05:00:00Z","tone":0.157},{"date":"2026-06-07T06:00:00Z","tone":0.128},{"date":"2026-06-07T07:00:00Z","tone":0.007},{"date":"2026-06-07T08:00:00Z","tone":0.311},{"date":"2026-06-07T09:00:00Z","tone":0.418},{"date":"2026-06-07T10:00:00Z","tone":-0.045},{"date":"2026-06-07T11:00:00Z","tone":0.062},{"date":"2026-06-07T12:00:00Z","tone":0.327},{"date":"2026-06-07T13:00:00Z","tone":-0.365},{"date":"2026-06-07T14:00:00Z","tone":-0.254},{"date":"2026-06-07T15:00:00Z","tone":-0.003},{"date":"2026-06-07T16:00:00Z","tone":-0.009},{"date":"2026-06-07T17:00:00Z","tone":0.294},{"date":"2026-06-07T19:00:00Z","tone":0.269},{"date":"2026-06-07T20:00:00Z","tone":1.051},{"date":"2026-06-07T21:00:00Z","tone":1.028},{"date":"2026-06-07T22:00:00Z","tone":0.582},{"date":"2026-06-08T00:00:00Z","tone":0.455},{"date":"2026-06-08T01:00:00Z","tone":0.103},{"date":"2026-06-08T02:00:00Z","tone":0.108},{"date":"2026-06-08T03:00:00Z","tone":0.189},{"date":"2026-06-08T04:00:00Z","tone":0.236},{"date":"2026-06-08T05:00:00Z","tone":0.653},{"date":"2026-06-08T06:00:00Z","tone":0.268},{"date":"2026-06-08T07:00:00Z","tone":0.038},{"date":"2026-06-08T08:00:00Z","tone":0.341},{"date":"2026-06-08T09:00:00Z","tone":0.454},{"date":"2026-06-08T10:00:00Z","tone":0.378},{"date":"2026-06-08T11:00:00Z","tone":0.065},{"date":"2026-06-08T12:00:00Z","tone":0.668},{"date":"2026-06-08T13:00:00Z","tone":1.059},{"date":"2026-06-08T14:00:00Z","tone":0.331},{"date":"2026-06-08T15:00:00Z","tone":0.521},{"date":"2026-06-08T16:00:00Z","tone":0.735},{"date":"2026-06-08T17:00:00Z","tone":0.412},{"date":"2026-06-08T18:00:00Z","tone":1.008},{"date":"2026-06-08T19:00:00Z","tone":0.836},{"date":"2026-06-08T20:00:00Z","tone":0.516},{"date":"2026-06-08T21:00:00Z","tone":0.638},{"date":"2026-06-08T22:00:00Z","tone":0.322},{"date":"2026-06-08T23:00:00Z","tone":0.336},{"date":"2026-06-09T00:00:00Z","tone":0.521},{"date":"2026-06-09T01:00:00Z","tone":0.101},{"date":"2026-06-09T02:00:00Z","tone":0.234},{"date":"2026-06-09T03:00:00Z","tone":0.366},{"date":"2026-06-09T04:00:00Z","tone":0.665},{"date":"2026-06-09T05:00:00Z","tone":0.375},{"date":"2026-06-09T06:00:00Z","tone":0.295},{"date":"2026-06-09T07:00:00Z","tone":0.289},{"date":"2026-06-09T08:00:00Z","tone":0.422},{"date":"2026-06-09T09:00:00Z","tone":0.382},{"date":"2026-06-09T10:00:00Z","tone":0.999},{"date":"2026-06-09T11:00:00Z","tone":0.148},{"date":"2026-06-09T12:00:00Z","tone":1.048},{"date":"2026-06-09T13:00:00Z","tone":0.562},{"date":"2026-06-09T14:00:00Z","tone":0.827},{"date":"2026-06-09T15:00:00Z","tone":0.649},{"date":"2026-06-09T16:00:00Z","tone":0.597},{"date":"2026-06-09T17:00:00Z","tone":0.368},{"date":"2026-06-09T18:00:00Z","tone":0.384},{"date":"2026-06-09T19:00:00Z","tone":0.031},{"date":"2026-06-09T20:00:00Z","tone":0.21},{"date":"2026-06-09T21:00:00Z","tone":0.021},{"date":"2026-06-09T22:00:00Z","tone":-0.346},{"date":"2026-06-09T23:00:00Z","tone":-0.774},{"date":"2026-06-10T00:00:00Z","tone":-0.519},{"date":"2026-06-10T01:00:00Z","tone":-0.607},{"date":"2026-06-10T02:00:00Z","tone":-0.487},{"date":"2026-06-10T03:00:00Z","tone":-0.267},{"date":"2026-06-10T04:00:00Z","tone":0.195},{"date":"2026-06-10T05:00:00Z","tone":0.502},{"date":"2026-06-10T06:00:00Z","tone":-0.273},{"date":"2026-06-10T07:00:00Z","tone":0.077},{"date":"2026-06-10T08:00:00Z","tone":0.332},{"date":"2026-06-10T09:00:00Z","tone":0.883},{"date":"2026-06-10T10:00:00Z","tone":0.736},{"date":"2026-06-10T11:00:00Z","tone":1.057},{"date":"2026-06-10T12:00:00Z","tone":1.017},{"date":"2026-06-10T13:00:00Z","tone":1.048},{"date":"2026-06-10T14:00:00Z","tone":0.39},{"date":"2026-06-10T15:00:00Z","tone":0.371},{"date":"2026-06-10T16:00:00Z","tone":0.025},{"date":"2026-06-10T17:00:00Z","tone":0.463},{"date":"2026-06-10T18:00:00Z","tone":0.58},{"date":"2026-06-10T19:00:00Z","tone":0.366},{"date":"2026-06-10T20:00:00Z","tone":0.26},{"date":"2026-06-10T21:00:00Z","tone":-0.03},{"date":"2026-06-10T22:00:00Z","tone":-0.153},{"date":"2026-06-10T23:00:00Z","tone":-0.201},{"date":"2026-06-11T00:00:00Z","tone":0.08},{"date":"2026-06-11T01:00:00Z","tone":-0.08},{"date":"2026-06-11T02:00:00Z","tone":0.408},{"date":"2026-06-11T03:00:00Z","tone":-0.445},{"date":"2026-06-11T04:00:00Z","tone":-0.196},{"date":"2026-06-11T05:00:00Z","tone":-0.174},{"date":"2026-06-11T06:00:00Z","tone":0.226},{"date":"2026-06-11T07:00:00Z","tone":0.228},{"date":"2026-06-11T08:00:00Z","tone":0.555},{"date":"2026-06-11T09:00:00Z","tone":0.264},{"date":"2026-06-11T10:00:00Z","tone":0.557},{"date":"2026-06-11T11:00:00Z","tone":0.725},{"date":"2026-06-11T12:00:00Z","tone":0.781},{"date":"2026-06-11T13:00:00Z","tone":0.298},{"date":"2026-06-11T14:00:00Z","tone":0.839},{"date":"2026-06-11T15:00:00Z","tone":0.897},{"date":"2026-06-11T16:00:00Z","tone":0.697},{"date":"2026-06-11T17:00:00Z","tone":0.677},{"date":"2026-06-11T18:00:00Z","tone":0.555},{"date":"2026-06-11T19:00:00Z","tone":0.877},{"date":"2026-06-11T20:00:00Z","tone":0.056},{"date":"2026-06-11T21:00:00Z","tone":0.432},{"date":"2026-06-11T22:00:00Z","tone":0.4},{"date":"2026-06-11T23:00:00Z","tone":0.058},{"date":"2026-06-12T00:00:00Z","tone":0.162},{"date":"2026-06-12T01:00:00Z","tone":0.189},{"date":"2026-06-12T02:00:00Z","tone":-0.037},{"date":"2026-06-12T03:00:00Z","tone":0.71},{"date":"2026-06-12T04:00:00Z","tone":0.966}],"recent_articles":[],"volume_timeline":[]}},"exampleRequest":{"q":"artificial intelligence","timespan":"1w"},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oiT8xkFkcT4usXSUWHWrg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns media sentiment analysis and tone scoring for a search query over a specified timespan, powered by GDELT news data","exampleAgentPrompt":"What's the current news sentiment for Nvidia over the past week — is coverage trending positive or negative, and can you show me the tone timeline?","exampleUseCases":[{"title":"Monitor earnings season market sentiment","prompt":"I'm tracking Apple ahead of their earnings call next week. Can you pull the latest news sentiment for Apple and show me if coverage has been improving or getting more negative over the last few days?"},{"title":"Assess Fed policy press coverage","prompt":"Show me how the media is covering the Federal Reserve's recent interest rate decisions. Is the overall tone positive or negative, and has it shifted over the past two weeks?"},{"title":"Track competitor perception shifts","prompt":"I need to compare news sentiment for Tesla versus traditional auto makers right now. Pull the tone data for both and show me which one is getting better press coverage lately."}],"resultDescription":"Returns a sentiment object with average and latest GDELT tone scores (roughly -10 to +10), a label (positive/neutral/negative), a trend direction (improving/worsening), a hourly tone timeline, an article volume timeline with total monitored count, and a list of recent articles with titles, URLs, domains, and publication times — all attributed to the GDELT Project.","failureModes":["Missing required 'q' parameter returns validation error","Query string too short (under 2 chars) or too long (over 120 chars) fails schema validation","Invalid timespan value outside enum fails validation","No matching news coverage for obscure query returns empty or null tone values","Payment failure via x402/USDC returns 402 Payment Required","GDELT upstream outage may cause delayed or unavailable data"],"whenToPreferThis":"Use this endpoint when you need structured, quantified news sentiment for any financial asset, company, macro topic, or public figure — especially when you need tone trends over time (hourly timeline) rather than just a headline score. Prefer this over generic social sentiment APIs when you want news media coverage specifically, backed by GDELT's global news monitoring. Ideal for AI agents making investment-adjacent decisions or summarizing how the press is covering a topic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:46:50.562Z","isFirstParty":false}