# Google News Scraper (`mangudai/google-news-scraper`) Actor

Scrape Google News by keyword, topic, or top headlines. Get headline, source, publish time, article link, and a snippet as clean structured rows. Built on the public Google News RSS feed: no login, no API key, no captcha. Runs on Apify Proxy.

- **URL**: https://apify.com/mangudai/google-news-scraper.md
- **Developed by:** [Mangudäi](https://apify.com/mangudai) (community)
- **Categories:** News, Developer tools, Open source
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.20 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Google News Scraper

Pull live Google News results by keyword, topic, or top headlines and get them back as clean, structured rows. Built on the public Google News RSS feed, so there is no login, no API key, and no captcha. Route it through Apify Proxy and run it on a schedule, via API, or from your own code.

### What it does

Give it a search term and it returns the matching news articles: headline, source, publish time, article link, and a short snippet. Skip the search term and pick a topic (technology, business, sports, and the rest) to get that section's headlines, or leave both empty for the top headlines of the day.

### Input

- `query`: keyword or phrase to search. Supports Google News operators like `when:7d`, `site:reuters.com`, and `OR`.
- `additionalQueries`: extra search terms to fetch in the same run, one feed each.
- `topic`: section headlines (World, Nation, Business, Technology, Entertainment, Sports, Science, Health). Used only when no query is set.
- `language`: interface language, for example `en-US`, `fr`, `de`.
- `country`: edition country, for example `US`, `GB`, `IN`.
- `maxItemsPerQuery`: cap per feed. Google News RSS returns up to about 100 items per feed. `0` means no cap.
- `proxyConfiguration`: Apify Proxy settings.

Default run: searches `artificial intelligence` and returns up to 50 recent articles.

### Output

One row per article:

- `title`: headline with the trailing source name removed
- `fullTitle`: original headline as Google returns it
- `source`: publisher name
- `sourceUrl`: publisher homepage
- `link`: Google News article link
- `guid`: stable article id
- `publishedAt`: ISO 8601 timestamp
- `publishedRaw`: original RFC 822 date string
- `snippet`: short text description
- `query`, `topic`, `feedTitle`: what produced the row

### Notes

Google News RSS caps each feed at roughly 100 items. To gather more, split your work across several queries (use `additionalQueries`) or narrow with date operators such as `when:1d`. The scraper retries failed fetches and rotates the proxy IP between attempts.

# Actor input Schema

## `query` (type: `string`):

Keyword or phrase to search Google News. Supports Google News operators such as when:7d, site:, and OR. Leave empty to pull topic headlines or top headlines instead.

## `additionalQueries` (type: `array`):

Extra search terms to fetch in the same run, one feed each. Adds to the main query.

## `topic` (type: `string`):

Google News section headlines. Used only when no search query is provided.

## `language` (type: `string`):

Interface language code, for example en-US, en-GB, fr, de, es.

## `country` (type: `string`):

Edition country code, for example US, GB, CA, AU, IN.

## `maxItemsPerQuery` (type: `integer`):

Cap on articles saved per feed. Google News RSS returns up to about 100 items per feed. Set 0 for no cap.

## `proxyConfiguration` (type: `object`):

Route requests through Apify Proxy. Recommended for scale and reliability.

## Actor input object example

```json
{
  "query": "artificial intelligence",
  "additionalQueries": [],
  "topic": "",
  "language": "en-US",
  "country": "US",
  "maxItemsPerQuery": 50,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `articles` (type: `string`):

One item per news article parsed from the Google News RSS feed.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "query": "artificial intelligence",
    "additionalQueries": [],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("mangudai/google-news-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "query": "artificial intelligence",
    "additionalQueries": [],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("mangudai/google-news-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "query": "artificial intelligence",
  "additionalQueries": [],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call mangudai/google-news-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=mangudai/google-news-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/pH4KXLShcA4pBidNU/builds/iMola4ZwziQnU3xuY/openapi.json