{"uid":"cap_cSmta2IRVJF2A1T4Q1fuI","slug":"tanod-web-news-search-9e6380ed","name":"Tanod Web News Search","description":"Web tools: search, page to Markdown or screenshot, company profile and jobs, sitemaps, RDAP, IP.","url":"https://web.tanod.dev/v1/news/search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"lang":{"anyOf":[{"type":"string","maxLength":2,"minLength":2},{"type":"null"}],"default":null,"description":"Optional: only articles in this source language, ISO 639-1 (en, es, de, fr, ja ...)."},"limit":{"type":"integer","default":20,"maximum":50,"minimum":1,"description":"Most articles to return, 1-50 (default 20)."},"query":{"type":"string","maxLength":200,"minLength":1,"description":"Search words or a quoted phrase (1-200 printable characters), such as stablecoin regulation."},"since":{"anyOf":[{"type":"integer","maximum":168,"minimum":1},{"type":"null"}],"default":null,"description":"Optional: articles from the last 1-168 hours. Overrides timespan."},"domain":{"anyOf":[{"type":"string","maxLength":253,"minLength":3},{"type":"null"}],"default":null,"description":"Optional: only articles from this site and its subdomains, such as reuters.com."},"timespan":{"enum":["1h","6h","24h","3d","7d"],"type":"string","default":"24h","description":"Window when since is not given: 1h, 6h, 24h (default), 3d or 7d."},"sentiment":{"type":"boolean","default":false,"description":"Add a positive / negative / neutral label and score to each headline (English VADER heuristic)."}}},"responseSchema":{"type":"json","example":{"max":2,"lang":"en","count":2,"query":"stablecoin","domain":null,"source":"GDELT Project (gdeltproject.org)","articles":[{"url":"https://cryptobriefing.com/french-finance-panel-backs-taxing-bitcoin-to-stablecoin-swaps-in-2027-budget/","tone":-0.8,"title":"French finance panel backs taxing Bitcoin-to-stablecoin swaps in 2027 budget","domain":"cryptobriefing.com","themes":["ECON_CURRENCY_EXCHANGE_RATE","TAX"],"entities":["French Finance Committee"],"language":"en","published_at":"2026-10-09T13:00:00Z"},{"url":"https://cryptobriefing.com/ethereum-leads-stablecoin-market-cap-growth/","tone":1.2,"title":"Ethereum leads stablecoin market cap growth, adding $243M in a week","domain":"cryptobriefing.com","themes":["ECON_BITCOIN"],"entities":["Ethereum"],"language":"en","published_at":"2026-10-09T11:30:00Z"}],"timespan":"24h","attribution":{"url":"https://www.gdeltproject.org/","source":"The GDELT Project"},"untrusted_content":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_u4rmtLKLKWui-oIqKRI_9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search recent news articles by keyword with optional language, domain, time window, and sentiment filters, powered by the GDELT Project.","exampleAgentPrompt":"Search for news articles about stablecoin regulation from the last 24 hours — up to 20 results in English — and include a sentiment label for each headline.","exampleUseCases":[{"title":"Crypto market news monitoring","prompt":"Find me the top 20 English news articles about Bitcoin ETF from the last 6 hours, and add sentiment scores so I can see if coverage is positive or negative."},{"title":"Brand press coverage lookup","prompt":"Search for recent news about Tesla from the last 3 days, only from reuters.com, and give me up to 15 articles."},{"title":"Foreign language news research","prompt":"Find up to 30 news articles about the French presidential election written in French from the last 7 days."}],"resultDescription":"Returns a JSON object containing matching news articles (up to 50), each with title, URL, publication timestamp, source domain, detected themes, named entities, and a tone score. When sentiment is enabled, each article also includes a positive/negative/neutral label with a VADER score. The response includes total count, applied filters, timespan, and GDELT attribution metadata.","failureModes":["Query string too long (>200 chars) returns validation error","Language code not ISO 639-1 format causes rejection","Requesting more than 50 articles returns a 422 validation error","No articles found for niche query in narrow time window returns empty articles array","'since' value outside 1-168 hours range is rejected","Domain filter typo returns zero results silently"],"whenToPreferThis":"Choose this endpoint when you need structured, filterable news search with per-article metadata (themes, entities, tone) and optional sentiment scoring. It is especially useful when you need to scope results by language, source domain, or a specific recent time window (down to 1 hour). Prefer it over generic web search when you specifically need news articles with publication timestamps and editorial metadata rather than arbitrary web pages.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:44:24.790Z","isFirstParty":false,"canonicalSlug":"tanod-web-news-search-9e6380ed"}