# Pull news articles on any topic into your code as JSON

Send a topic to news.search, with a location and language when you need them, and get recent articles as JSON: title, source domain, snippet, URL, publication time and an image link. Results default to the United States. Use it to follow a market, a competitor or a category without reading news sites one by one.

HTML page: https://www.routergrowth.com/tools/web-scraping/news-api
Part of: [Web search and scraping tools](https://www.routergrowth.com/tools/web-scraping.md)

## The call

[`news.search`](https://www.routergrowth.com/catalog/news.search): Google News articles for a query and location: title, source, snippet, URL and publication time.

Price on this network: $0.0035 per search. The exact quote is shown before every run.

## What a real run returned

Run on 2026-10-26: 10 records in 4.5 s for $0.004. Personal fields are masked. Ten articles for battery recycling from the last week: an EV recycling partnership, a funding round, city disposal rules and new recycling labs, from trade press and local sites.

| published | source | title |
|---|---|---|
| 2026-10-23 | electrek.co | Redwood and Rivian set to expand their EV battery recycling partnership |
| 2026-10-23 | www.recyclingtoday.com | NEU Battery Materials closes $7.6M funding round |
| 2026-10-26 | www.greensboro-nc.gov | Skip the Bin. Turn Your Batteries In. |

## How to do it

1. **Pick the topic.** A few words work best: a category, a company or an event.
2. **Call news.search.** Send query, and location or language if the market is not the United States.
3. **Sort by published_at.** Order the articles by time and drop the URLs you already have.
4. **Read the ones that matter.** Run web.scrape on an article URL for the full text.

## Ask it like this

- Get this week's news on battery recycling and group the articles into funding, partnerships and regulation. (`news.search`)
- Find news on our three biggest competitors and scrape the two most recent articles about each. (`news.search`, `web.scrape`)

## Connect

MCP server: `https://api.routergrowth.com/mcp`

```bash
claude mcp add --transport http routergrowth https://api.routergrowth.com/mcp
```

```bash
npm install -g routergrowth && routergrowth setup
routergrowth run -c news.search -i '{"query": "battery recycling", "limit": 8}'
```

```bash
curl -X POST https://api.routergrowth.com/v1/run \
  -H "Authorization: Bearer $ROUTERGROWTH_API_KEY" \
  -d '{"capability": "news.search", "input": {"query": "battery recycling", "limit": 8}}'
```

## Worth knowing

- **Times are approximate.** Publication times come from labels such as 3 hours ago, so trust the day more than the minute. Some articles have no time.
- **Results come in tens.** Articles are fetched ten at a time, so a limit under ten can still return ten.
- **Snippets, not full text.** Each article carries a short snippet. Scrape the URL when you need the story itself.

## Questions

### Which countries can I search?

Pass a country, or a city and country, in location. The default is the United States.

### Does it return the full article?

No. It returns title, source, snippet, URL and time. Use web.scrape for the text.

### Can I search in another language?

Yes. Set language along with the location.

### How far back does it go?

Results lean recent but follow relevance, so older articles can appear. Check published_at.

## Related

- [Convert a web page into clean markdown your model can read](https://www.routergrowth.com/tools/web-scraping/website-to-markdown.md)
- [Search the web from code and get citable sources back as JSON](https://www.routergrowth.com/tools/web-scraping/web-search-api.md)
- [Ground an agent in sources from the domains you trust](https://www.routergrowth.com/tools/web-scraping/web-search-api-for-llm.md)
- [Turn a public page into agent ready text with a single request](https://www.routergrowth.com/tools/web-scraping/api.md)
- [Scrape public pages from a Python script with one POST request](https://www.routergrowth.com/tools/web-scraping/api-python.md)
- [Get the latest headlines on a listed company from its name and ticker](https://www.routergrowth.com/tools/web-scraping/stock-news-api.md)
- [Fetch news articles into a Python script with one POST](https://www.routergrowth.com/tools/web-scraping/news-api-python.md)
- [Get the articles Google News lists for a query, in one API call](https://www.routergrowth.com/tools/web-scraping/google-news-api.md)
- [Read a public Amazon product page from your agent, with no scraper to maintain](https://www.routergrowth.com/tools/web-scraping/amazon.md)