# Google News RSS Scraper: News by Keyword and Country (`variegated_binturong/google-news-rss`) Actor

Get the news for a list of keywords from the public Google News RSS feed, in your language and country: headline, source, link, publisher address when available, date and keyword. Last N days filter, cap per keyword, each story once. No login. Keywords without news never charged.

- **URL**: https://apify.com/variegated_binturong/google-news-rss.md
- **Developed by:** [Luigi Fiano](https://apify.com/variegated_binturong) (community)
- **Categories:** News, Marketing
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$1.00 / 1,000 news rows

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Google News RSS Scraper: News by Keyword and Country

Paste a list of keywords and get the latest news for each one from the public Google News RSS feed, in the language and country you choose. One row per news item: headline, source and its website, Google News link, the publisher's address when the link carries it, publication date, rank in the feed and the keyword that found it.

A story found by two keywords is delivered once. You can keep only the news of the last N days and cap the items per keyword.

### What it is for

- **Media monitoring**: your brand, your clients, your competitors and your topics, every morning (schedule the Actor).
- **Content ideas**: what the press is writing today about the subjects of your niche, in the countries you care about.
- **News feeds for tools and AI agents**: a clean JSON list of headlines, sources and dates to pass to an LLM for a daily digest.
- **Research**: how often a topic appears in the news of different countries and languages.

### How it works

- **One request per keyword**: the public RSS search feed of Google News, for the edition you choose (language + country). No browser, no login, no cookies.
- **Days filter**: with `days`, Google's own `when:` filter is added to the search, and every publication date is checked again before a row is delivered.
- **Duplicates**: the Google News link is the key. A story already delivered for an earlier keyword is skipped, and counted in the summary.
- **Publisher address**: Google News links redirect to the article. Older links carry the publisher's address inside them, and it is read without any extra request (`articleUrl`). Newer links do not carry it: `articleUrl` is then `null`, and `link` opens the article in a browser. `sourceUrl` (the publisher's website) is always there when the feed gives it.
- **Search operators**: a keyword can use Google News operators such as `"exact phrase"`, `OR`, `-word` and `site:example.com`.

### Input

| Field | What it does | Default |
|---|---|---|
| `keywords` | One keyword or phrase per line | required |
| `language` | Edition language: `en`, `it`, `de`, `fr`, `es`... or with a region: `en-GB`, `pt-BR`, `es-419` | `en` |
| `country` | Edition country, two letters: `US`, `GB`, `IT`, `DE`, `IN`... | `US` |
| `maxItemsPerKeyword` | Keep at most this many items per keyword, in feed order (1 to 100) | 100 |
| `days` | Only news of the last N days (0: no filter) | 0 |
| `concurrency`, `timeoutSecs`, `maxRetries` | Speed and resilience | 2, 30, 2 |
| `maxKeywords`, `maxResults` | Safety caps (0: no limit on rows) | 1000, 0 |

English editions get the country as region (`en` + `GB` is the en-GB edition); other languages use the plain language unless you add a region.

```json
{
  "keywords": ["artificial intelligence", "electric cars", "\"renewable energy\" site:example.com"],
  "language": "en",
  "country": "US",
  "maxItemsPerKeyword": 20,
  "days": 7
}
```

### Output

One row per news item. These rows come from the Actor's own test, on a sample feed (the article id inside each Google News link is shortened here):

```json
[
  {
    "type": "news",
    "keyword": "artificial intelligence",
    "position": 1,
    "title": "Demand for AI chips keeps growing",
    "source": "Example News",
    "sourceUrl": "https://www.example-news.com",
    "link": "https://news.google.com/rss/articles/CBMi…?oc=5",
    "articleUrl": "https://www.example-news.com/tech/ai-chips-demand-2026",
    "publishedAt": "2026-11-09T06:30:00.000Z",
    "language": "en-US",
    "country": "US",
    "input": "artificial intelligence",
    "error": null,
    "scrapedAt": "2026-11-09T05:00:00.000Z"
  },
  {
    "type": "news",
    "keyword": "artificial intelligence",
    "position": 2,
    "title": "What the new AI rules mean for small firms",
    "source": "Example Daily",
    "sourceUrl": "https://exampledaily.org",
    "link": "https://news.google.com/rss/articles/CBMi…?oc=5",
    "articleUrl": null,
    "publishedAt": "2026-11-08T18:00:00.000Z",
    "language": "en-US",
    "country": "US",
    "input": "artificial intelligence",
    "error": null,
    "scrapedAt": "2026-11-09T05:00:00.000Z"
  }
]
```

- `title` is the headline without the " - Source" ending that Google News adds; the source has its own field.
- `position` is the rank of the item in the keyword's feed (1 is the first).
- `publishedAt` is in ISO format, UTC.
- No personal data: only headlines, sources, links and dates.

#### Keywords without news or that cannot be read (not charged)

A keyword whose feed has no news, or cannot be read, never becomes a dataset row, so it costs nothing. It is listed with the reason in the `ERRORS` record of the key-value store (also in the Output tab):

```json
{ "type": "error", "keyword": "zzqx-no-news-term-4821", "input": "zzqx-no-news-term-4821", "feedUrl": "https://news.google.com/rss/search?q=zzqx-no-news-term-4821%20when%3A7d&hl=en-US&gl=US&ceid=US:en", "statusCode": null, "error": "no news found for this keyword in the en-US / US edition in the last 7 day(s)", "scrapedAt": "2026-11-09T05:00:00.000Z" }
```

Other reasons you can see: `no news from the last 7 day(s) for this keyword`, `every news item of this keyword was already delivered for another keyword (duplicates are delivered once)`, `rate limited by Google News (HTTP 429): lower the concurrency and try again later`, `Google News did not return an RSS feed`, `request failed: timeout`.

#### Summary

The `SUMMARY` record has the edition used and the run totals: `keywordsChecked`, `keywordsWithNews`, `keywordsWithoutNews`, `keywordsWithError`, `duplicatesSkipped`, `olderSkipped`, `rows`, `stoppedEarly` and `rowsPerKeyword`.

### Pricing

Pay per result: **$0.001 per news row** in the dataset ($1 per 1,000 news items). Keywords without news or whose feed cannot be read are not charged: they go to the free `ERRORS` record. Use `maxItemsPerKeyword` and `maxResults` to cap the cost of a run.

### Tips

- Daily monitoring: schedule the Actor every morning with `days: 1`, so each run brings only the news of the last day.
- Several countries: run the Actor once per edition (for example `en` + `US`, `en` + `GB`, `it` + `IT`) with the same keywords.
- Narrow a keyword with operators: `"exact phrase"`, `-word`, `site:example.com`.

### Notes

- Only the public Google News RSS feed. No login, no cookies, no proxies, nothing bypassed.
- Headlines belong to their publishers: use them as links and references, and check each publisher's terms before reusing their text.
- Not affiliated with Google. Google News is a trademark of Google LLC.

# Actor input Schema

## `keywords` (type: `array`):

One keyword or phrase per line (spaces stay inside the keyword). Google News search operators such as "exact phrase", OR, -word and site:example.com can be used. Duplicates are removed; lines starting with # are comments.

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

Language of the Google News edition: en, it, de, fr, es, ja... Add a region when needed: en-GB, pt-BR, es-419 (Latin America).

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

Two-letter country code of the edition: US, GB, IT, DE, FR, IN, BR...

## `maxItemsPerKeyword` (type: `integer`):

Keep at most this many news items per keyword, in the order of the feed.

## `days` (type: `integer`):

Only news published in the last N days: Google's own when: filter is added to the search and every date is checked again. 0: no date filter.

## `concurrency` (type: `integer`):

How many keywords are read at the same time.

## `timeoutSecs` (type: `integer`):

Give up on a feed after this many seconds.

## `maxRetries` (type: `integer`):

How many times a feed is requested again after a timeout, a 429 or a 5xx answer. Retry-After is honoured (max 30 s).

## `maxKeywords` (type: `integer`):

Safety cap on the number of keywords processed.

## `maxResults` (type: `integer`):

Stop after this many dataset rows. 0: no limit.

## Actor input object example

```json
{
  "keywords": [
    "artificial intelligence",
    "electric cars"
  ],
  "language": "en",
  "country": "US",
  "maxItemsPerKeyword": 100,
  "days": 0,
  "concurrency": 2,
  "timeoutSecs": 30,
  "maxRetries": 2,
  "maxKeywords": 1000,
  "maxResults": 0
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

## `errors` (type: `string`):

No description

# 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 = {
    "keywords": [
        "artificial intelligence",
        "electric cars"
    ],
    "language": "en",
    "country": "US"
};

// Run the Actor and wait for it to finish
const run = await client.actor("variegated_binturong/google-news-rss").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 = {
    "keywords": [
        "artificial intelligence",
        "electric cars",
    ],
    "language": "en",
    "country": "US",
}

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

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

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

```

## CLI example

```bash
echo '{
  "keywords": [
    "artificial intelligence",
    "electric cars"
  ],
  "language": "en",
  "country": "US"
}' |
apify call variegated_binturong/google-news-rss --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,variegated_binturong/google-news-rss"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/JgOzqI5LsAwxUIC6o/builds/6aaiMihGRFGdplVQ7/openapi.json
