---
title: ToolRouter — Tool Detail
description: Detailed documentation for a ToolRouter tool including skills, parameters, and examples.
url: https://toolrouter.com/tools/news
---
# News

Track breaking stories, search by keyword, monitor locations, and follow specific publishers. Covers trending headlines, location-based news, and publisher feeds. Supports 50+ regional editions in local languages with source attribution and direct links.

- **Version:** 0.03
- **Categories:** search, data
- **Workflow:** search_news → trending_news → trending_news → search_news → location_news → search_news → publisher_news

## Skills (4)

### Search News (`search_news`)

Find news articles matching a keyword or phrase with optional filters for time range, location, and publisher. The most flexible way to find specific coverage on any topic.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Search query — keywords, phrases, or advanced operators. Supports: "exact phrase", OR, AND, -exclude. |
| `exact_phrase` | string | No | Find articles containing this exact phrase (wraps in quotes automatically) |
| `exclude` | string | No | Comma-separated terms to exclude from results (e.g. "opinion,editorial,sponsored") |
| `site` | string | No | Limit results to a specific publisher domain (e.g. "reuters.com", "bbc.co.uk") |
| `location` | string | No | Filter by geographic location (e.g. "London", "California", "Japan") |
| `when` | string | No | Time filter — 1h (last hour), 1d (last day), 7d (last week), 30d (last month) (1h, 1d, 7d, 30d) |
| `region` | string | No | Regional edition code (default: us). 50+ regions: us, uk, au, ca, in, de, fr, es, it, br, jp, kr, mx, and more. [default: "us"] |
| `count` | number | No | Number of articles to return (default: 20, max: 100) [default: 20] |

**Returns:** Structured array of news articles matching the query — each with title, direct link, source name, publication date (human + ISO 8601), and related articles with links

**Examples:**

*Search for AI news:*

```json
{
  "query": "artificial intelligence"
}
```

*Search for climate news in the UK from the last week:*

```json
{
  "query": "climate change",
  "region": "uk",
  "when": "7d",
  "count": 10
}
```

*Search with exact phrase and exclusions:*

```json
{
  "query": "electric vehicles",
  "exact_phrase": "battery technology",
  "exclude": "opinion,editorial"
}
```

*Search a specific publisher for a topic:*

```json
{
  "query": "interest rates",
  "site": "reuters.com",
  "when": "1d"
}
```

*Search by location:*

```json
{
  "query": "earthquake",
  "location": "California",
  "when": "7d"
}
```

### Trending News (`trending_news`)

Get top headlines and trending stories right now, optionally filtered by topic and region.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `topic` | string | No | News topic to filter by. Omit for top stories across all topics. (world, nation, business, technology, entertainment, sports, science, health) |
| `region` | string | No | Regional edition code (default: us). 50+ regions: us, uk, au, ca, in, de, fr, es, it, br, jp, kr, mx, and more. [default: "us"] |
| `count` | number | No | Number of articles to return (default: 20, max: 100) [default: 20] |

**Returns:** Trending news articles with title, source, image thumbnail, publication date, link, and related articles — sorted by prominence

**Examples:**

*Get top headlines:*

```json
{}
```

*Get technology news:*

```json
{
  "topic": "technology"
}
```

*Get business news from Germany:*

```json
{
  "topic": "business",
  "region": "de",
  "count": 10
}
```

*Get sports headlines from Japan:*

```json
{
  "topic": "sports",
  "region": "jp"
}
```

### Location News (`location_news`)

Get news about a specific city, state, or country. Useful for local news monitoring, travel research, and regional event tracking.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `location` | string | Yes | Geographic location — city name, state, region, or country (e.g. "London", "California", "Brazil", "Tokyo") |
| `topic` | string | No | Optional topic to narrow results within the location (e.g. "technology", "crime", "weather", "elections") |
| `when` | string | No | Time filter — 1h (last hour), 1d (last day), 7d (last week), 30d (last month) (1h, 1d, 7d, 30d) |
| `region` | string | No | Regional edition code (default: us). 50+ regions: us, uk, au, ca, in, de, fr, es, it, br, jp, kr, mx, and more. [default: "us"] |
| `count` | number | No | Number of articles to return (default: 20, max: 100) [default: 20] |

**Returns:** News articles related to the specified location — each with title, source, image thumbnail, publication date, link, and related articles

**Examples:**

*Get news about London:*

```json
{
  "location": "London"
}
```

*Get technology news from Silicon Valley:*

```json
{
  "location": "Silicon Valley",
  "topic": "technology"
}
```

*Recent news about Tokyo in the last day:*

```json
{
  "location": "Tokyo",
  "when": "1d",
  "region": "jp"
}
```

*Crime news in Chicago this week:*

```json
{
  "location": "Chicago",
  "topic": "crime",
  "when": "7d"
}
```

### Publisher News (`publisher_news`)

Get recent articles from a specific news outlet by name or domain. Supports 40+ major publishers and any custom domain.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `publisher` | string | Yes | Publisher name (reuters, bbc, cnn, nytimes, bloomberg, wsj, etc.) or any domain (e.g. "arstechnica.com") |
| `topic` | string | No | Optional topic to filter articles from this publisher (e.g. "AI", "climate", "earnings") |
| `when` | string | No | Time filter — 1h (last hour), 1d (last day), 7d (last week), 30d (last month) (1h, 1d, 7d, 30d) |
| `region` | string | No | Regional edition code (default: us). 50+ regions: us, uk, au, ca, in, de, fr, es, it, br, jp, kr, mx, and more. [default: "us"] |
| `count` | number | No | Number of articles to return (default: 20, max: 100) [default: 20] |

**Returns:** Articles from the specified publisher with title, source, image thumbnail, publication date, link, and related articles. Includes list of known publisher shortcuts.

**Examples:**

*Get latest Reuters articles:*

```json
{
  "publisher": "reuters"
}
```

*Get BBC technology coverage:*

```json
{
  "publisher": "bbc",
  "topic": "technology"
}
```

*Get New York Times articles from the last week:*

```json
{
  "publisher": "new york times",
  "when": "7d",
  "count": 15
}
```

*Get TechCrunch articles about AI:*

```json
{
  "publisher": "techcrunch",
  "topic": "artificial intelligence"
}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call news search_news --query artificial intelligence

# Via REST API
curl -H "Authorization: Bearer tr_live_xxx" \
     -d '{"tool":"news","skill":"search_news","input":{"query":"artificial intelligence"}}' \
     https://api.toolrouter.com/v1/tools/call
```

## Frequently Asked Questions

### How do I find coverage for a specific topic or phrase?

`search_news` is the most flexible option. It supports exact phrases, exclusions, site filters, location filters, and time windows.

### How do I see today's biggest headlines?

`trending_news` returns the current top stories, with optional region and topic filters.

### Can I track local news or a specific outlet?

Yes. `location_news` focuses on a city, state, or country, and `publisher_news` pulls recent articles from a named outlet or domain.

### Can I narrow results to a region or a recent time window?

Yes. Use `region` for localized editions and `when` for recency, from 1 hour to 30 days.

---

## Get Started with ToolRouter

**Already connected?** Call any tool with `use_tool({ tool, skill, input })`. Browse tools with `discover` or visit https://toolrouter.com/llms-full.txt

**New to ToolRouter?** Connect with one command (no API key needed — auto-provisions on first use):

```bash
# MCP (Claude Code, Codex CLI)
claude mcp add toolrouter -- npx -y toolrouter-mcp

# MCP (Cursor, Windsurf, Cline, VS Code, Gemini CLI, Claude Desktop)
{"mcpServers":{"toolrouter":{"command":"npx","args":["-y","toolrouter-mcp"]}}}

# Claude Chat / Claude Cowork / Claude Mobile — add as a connector:
# Settings → Connectors → Add custom connector → URL: https://api.toolrouter.com/mcp

# ChatGPT — add as an app:
# Settings → Apps → Advanced settings → enable Developer mode → Create app → MCP Server URL: https://api.toolrouter.com/mcp

# CLI (works instantly, no restart needed)
npx -y toolrouter-mcp tools                    # browse all tools
npx -y toolrouter-mcp search "seo"             # search by keyword
npx -y toolrouter-mcp call seo analyze_page --url https://example.com
```

Free tools work immediately. For paid tools, visit https://toolrouter.com/claim to add credits.

All platforms: https://toolrouter.com/connect | Full catalog: https://toolrouter.com/llms-full.txt | Docs: https://toolrouter.com/docs