Search news
search_newsSearch recent news from the last 30 days in any language, returning ranked, story-grouped articles with summaries, sources, dates, and links to track companies, people, topics, or events.
Instructions
Search recent news (last 30 days, every language) and get the best articles, ranked and grouped into stories, each with a one-line summary, source, date and link. Use it for anything news-shaped: what happened, latest developments, coverage of a company, person, topic or event, or checking if something was reported. It keeps to real news sources, groups articles into stories (with a newsroom count), translates titles and summaries, and takes exact time windows. For an exact count or every matching article use list_articles; for older news (up to 12 months) use list_articles; to build a dataset or watch companies use start_research.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_news"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | relevance (default) or newest first. | relevance |
| group | No | diverse (default): best articles with repeats of one story discounted; story: one article per story (widest coverage of distinct events); all: every matching article. | diverse |
| limit | No | Articles to return (default 10; the free plan allows up to 50). | |
| query | Yes | What to find: a plain-language question or keywords, any language (e.g. "Nvidia earnings guidance", "who is acquiring European banks?"). Upper-case NOT drops a term: "Apple NOT iPhone". | |
| effort | No | Ranking effort and price: low (1 credit, ~4 s), medium (default, 5 credits, ~8 s, reranked), high (10 credits, ~25 s, LLM-judged, merges duplicate stories). | medium |
| format | No | text (default, compact) or json (machine-readable). | text |
| window | No | How far back from now: e.g. "2h", "1d", "7d" (default), up to "30d" (longer windows are cut to 30 days; use list_articles for older news). | |
| sources | No | Only these publishers: domains, e.g. ["reuters.com","ft.com"]. | |
| countries | No | Only publishers from these countries: ISO 3166-1 alpha-2 codes, e.g. ["US","GB"]. | |
| languages | No | Only these languages: ISO 639-1 codes, e.g. ["en","de"]. | |
| min_newsrooms | No | Only stories covered by at least this many newsrooms (a proxy for importance). | |
| exclude_sources | No | Leave out these publishers (domains). | |
| include_non_news | No | Also return non-news content (press releases, blogs, opinion). Default false: real news only. | |
| exclude_countries | No | Leave out publishers from these countries (ISO 3166-1 alpha-2). | |
| exclude_languages | No | Leave out these languages (ISO 639-1). |