# Google News Scraper: search, topics and local news as JSON (`subimpact/google-news-rss-scraper`) Actor

Google News as JSON from search queries (with operators like when:7d and site:), topic feeds and local feeds: headline, publisher, resolved publisher URL, publish time, source domain and related stories. No browser, no API key. From $1.00 per 1,000 articles.

- **URL**: https://apify.com/subimpact/google-news-rss-scraper.md
- **Developed by:** [subimpact](https://apify.com/subimpact) (community)
- **Categories:** News, SEO tools, Developer tools
- **Features:** Limited permissions
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.70 / 1,000 article scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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: Google News as JSON

Turn Google News into clean JSON rows. Give it search queries, topic headlines or place feeds, and get one row
per article with the headline, publisher, **the real publisher URL** (not just a `news.google.com` link),
publication time in ISO 8601 UTC, source domain and the cluster of related articles Google groups around the
story.

No API key, no browser, plain HTTP. Google's own RSS feeds are the source, so every row is exactly what Google
News shows — including the edition, language and ranking you ask for.

### Why this one

- **Publisher URLs, resolved.** Google News links are opaque ids (`news.google.com/rss/articles/CBMi…`). Every
  row also carries `publisherUrl`, the article on the publisher's own site, resolved through Google's public
  article endpoint — measured 100% on live runs.
- **Google search operators work.** Quotes for exact phrases, `site:` to restrict a publisher, `when:7d` /
  `when:1h` for recency, `-term` to exclude, `OR` to combine. They are passed through to Google as-is.
- **Three feed types.** Keyword search, the eight topic pages (World, Nation, Business, Technology,
  Entertainment, Sports, Science, Health) and geo feeds for places.
- **Cluster data.** Topic and geo rows include `relatedArticles`: the other outlets covering the same story, with
  their own Google News links — useful for deduplication, source diversity and "who else reported this".
- **Any Google News edition.** `language` + `country` select the edition (en-US/US, en-MY/MY, en-SG/SG, ms-MY/MY,
  id/ID, …), which changes both the articles and their language.

Typical uses: brand and PR monitoring, competitor tracking, a news dashboard or alerting pipeline, filling a
newsletter or RAG store with linkable articles, and regional coverage where the local edition matters.

### Input

```json
{
  "queries": ["\"electric vehicles\" when:7d", "site:reuters.com palm oil"],
  "topics": ["BUSINESS", "TECHNOLOGY"],
  "geos": ["Malaysia"],
  "language": "en-MY",
  "country": "MY",
  "maxArticlesPerFeed": 50,
  "maxItems": 200,
  "resolveUrls": true
}
```

| Input | Default | What it does |
| --- | --- | --- |
| `queries` | prefill `["malaysia economy"]` | Google News search queries, one feed each. Search operators allowed. |
| `topics` | `[]` | Any of `WORLD`, `NATION`, `BUSINESS`, `TECHNOLOGY`, `ENTERTAINMENT`, `SPORTS`, `SCIENCE`, `HEALTH`. |
| `geos` | `[]` | Place names for geo feeds (`Malaysia`, `Penang`, `Singapore`, `London`). |
| `language` | `en-US` | Google interface locale (`hl`): `en-US`, `en-GB`, `en-MY`, `ms-MY`, `id`, `pt-BR`, `zh-CN`, … |
| `country` | `US` | Two-letter country for the edition (`gl`). With the language it forms Google's `ceid` (`MY` + `en-MY` → `MY:en`). |
| `maxArticlesPerFeed` | `100` | Rows taken per feed, in Google's ranking order. Google returns at most ~100 items per feed. |
| `maxItems` | `300` | Hard cap on delivered rows for the whole run (max 10,000). |
| `resolveUrls` | `true` | Resolve `publisherUrl` for each article. Turn it off for a metadata-only run (faster, same price). |
| `proxyConfiguration` | none | Optional Apify Proxy, only needed if Google starts rate-limiting your runs. |

Using only part of the input is fine — every combination of queries, topics and geos works, and a run with
nothing selected stops with a clear error instead of scraping or charging anything.

### What one row looks like

| Field | Meaning |
| --- | --- |
| `feedType` | `search`, `topic` or `geo` — which Google News feed produced the row |
| `feed` | The query, topic or place you asked for (the value from `queries` / `topics` / `geos`) |
| `feedUrl` | The exact RSS URL fetched, incl. `hl`, `gl`, `ceid` — every row is reproducible |
| `position` | 1-based position inside the feed, i.e. Google's ranking |
| `title` | Headline exactly as Google returns it (Google appends ` - <publisher>`) |
| `publisher` | Publisher name from Google's `<source>` element |
| `publisherUrl` | The article on the publisher's site, resolved from Google's id (`null` if it could not be resolved — `googleNewsUrl` is always there) |
| `googleNewsUrl` | Google News link for the article |
| `publishedAt` | Publication time, ISO 8601 UTC |
| `snippet` | Summary text, HTML stripped. Google's standard feeds ship headline + publisher only, so this is usually `null` |
| `sourceDomain` | Publisher domain from Google's `<source url>` (`reuters.com`, no `www`) |
| `relatedArticles` | Cluster of other articles on the same story: `[{title, publisher, url}]`, excluding this row's article. `[]` when Google clusters nothing |
| `language`, `country` | The `hl` / `gl` the feed was requested with |
| `scrapedAt` | When the row was built, ISO 8601 UTC |
| `status` | `Success` for a delivered article, or `Empty` / `Error` for a feed-level problem row (never charged) |
| `urlResolvedBy` | How `publisherUrl` was obtained: `batchexecute` (Google's RPC), `articleId` (decoded from the id, no request), `none`, `page` (article page unusable), `error`, `skipped` (resolution time budget used), `disabled` (`resolveUrls: false`) |
| `error` | Why an `Empty` / `Error` row has no article; `null` on `Success` rows |

### Example output

A real row from a live run (`{"queries": ["malaysia economy"]}`, 15 November 2026):

```json
{
  "feedType": "search",
  "feed": "malaysia economy",
  "feedUrl": "https://news.google.com/rss/search?q=malaysia%20economy&hl=en-US&gl=US&ceid=US%3Aen",
  "position": 1,
  "title": "Malaysia - Trade, Manufacturing, Services - Britannica",
  "publisher": "Britannica",
  "publisherUrl": "https://www.britannica.com/place/Malaysia/Economy",
  "googleNewsUrl": "https://news.google.com/rss/articles/CBMiXkFVX3lxTE1sTVdHbUlkX0MzMndNMHg0SUI4OFdrQUlHVzM4NWxGblJ0QUl4aWFqNXYzSG0zaXlZSVFUX0hWb0hDeE9GZFh0LXNZT0FINHk5bmRCcXlyLVpieEJ3YXc?oc=5",
  "publishedAt": "2026-11-12T08:00:00.000Z",
  "snippet": null,
  "sourceDomain": "britannica.com",
  "relatedArticles": [],
  "language": "en-US",
  "country": "US",
  "scrapedAt": "2026-11-15T08:45:45.510Z",
  "status": "Success",
  "urlResolvedBy": "batchexecute",
  "error": null
}
```

A topic row from the same day (`{"topics": ["BUSINESS"], "maxArticlesPerFeed": 4}`), shortened to two related
articles — this is the cluster Google puts around a story, minus the row's own article:

```json
{
  "feedType": "topic",
  "feed": "BUSINESS",
  "feedUrl": "https://news.google.com/rss/headlines/section/topic/BUSINESS?hl=en-US&gl=US&ceid=US%3Aen",
  "position": 1,
  "title": "FAA was warned for years about repair risks leading to nationwide ground stop - The Washington Post",
  "publisher": "The Washington Post",
  "publisherUrl": "https://www.washingtonpost.com/transportation/2026/11/14/faa-was-warned-years-about-repair-risks-leading-nationwide-ground-stop/",
  "googleNewsUrl": "https://news.google.com/rss/articles/CBMixwFBVV95cUxQdGhEX0dMOEdKd2dQcXJYV1NJVnZKeUFMTlMyRmVMWXFkZHhaU3hDR0NCM201VTZQRXc0QXNERjdBdGdyX3ZXU3ZlbU42WjR4MW5qLWh1WGtCdk9UVXdlaUlQMTJkS1FuWHhDcUt0MlNmQlRRYTdDSTh0Z3I0RTAwaGlYdzByVG05WE1uZjdyeWhiQlYtRmRRSkwtOVR0WS14X1VOZ25JZzVHMFFJNEhMUW9YWWtKVTM3cG5McHJDbjJGWWFfMTZV?oc=5",
  "publishedAt": "2026-11-15T04:37:00.000Z",
  "snippet": null,
  "sourceDomain": "washingtonpost.com",
  "relatedArticles": [
    {
      "title": "US aviation shutdown blamed on L3 Harris installed router",
      "publisher": "Reuters",
      "url": "https://news.google.com/rss/articles/CBMiuAFBVV95cUxQWEQ1ckJVbXlQSHI5ZHU4VEppWVVZbXBYa0ZRWjdDdFNGWWxSdHF5bEtwR1Q2OHRxN2plYXctMm5lTU5TV0hzb2xQazg4U09MNDhyRnpOalhGYXJWN01mak9NR0dXWG0yR0k5WUtycmNhdkdZZkpYcXp5N2w0N2RQSUxEX1F5aEY1TGhDTzV5ZXl3dWR6QmdabDduOFBBWTNPdXBvVVY1VlAwVW1XYnIyQ2FwU2ZOeW5x?oc=5"
    },
    {
      "title": "Sacramento airport travelers continue feeling effects of nationwide ground stop",
      "publisher": "CBS News",
      "url": "https://news.google.com/rss/articles/CBMilAFBVV95cUxPSHU5cnRUSGdWZloyUlU3Z24teWxuanR3QS13cUcwb290eDR4cHFjcm9majg2WC0wSzlKSU1SbU1CMFoxRWE0M0ozR2tUVENMamR0eUwxOFlRVDNJcFpIMTlXQS0yMnhDbGt2dGQ4RXE1eFV3TEJpOEhWaFRKYTZwSUgwcFZoTDcyLWttenJlU0NCcWpl?oc=5"
    }
  ],
  "language": "en-US",
  "country": "US",
  "scrapedAt": "2026-11-15T08:45:59.921Z",
  "status": "Success",
  "urlResolvedBy": "batchexecute",
  "error": null
}
```

### Search operators and editions

`queries` is passed to Google News, so anything Google News search accepts works:

- `"electric vehicles"` — exact phrase.
- `site:reuters.com palm oil` — one publisher only.
- `when:1h`, `when:7d`, `when:30d` — recency.
- `palm oil -Indonesia` — exclude a term.
- `(Malaysia OR Singapore) budget` — combine.

`language` and `country` decide the edition. `en-US` + `US` is the international English edition; `en-MY` + `MY`
is Malaysia's; `ms-MY` + `MY` is the Malay edition; `id` + `ID` is Indonesia's. Topic feeds follow the same
edition, so `NATION` means "your country" for that edition.

Geo feeds resolve places Google knows for that country — `Malaysia` and `Penang` work with `gl=MY`, while an
unknown or wrong-country place returns no items and one `Empty` row that is not charged.

### Pricing

**$1.00 per 1,000 articles** — one `article-scraped` event per delivered row ($0.001), charged only after the row
has been pushed. Empty and Error rows are free, and `maxItems` (default 300) keeps a run bounded: a default run of
one query costs about 10 cents.

The comparison that matters: comparable Google News scrapers on the Store charge about **$2–4 per 1,000**
articles, mostly on top of their own platform usage. This actor is $1.00 per 1,000 with no start fee beyond
Apify's $0.00005 minimum actor start event, and Apify platform usage (compute, and proxy if you switch it on) is
paid by you on top — a 300-row run is normally a couple of minutes on 512 MB.

### Limits and good to know

- Google's RSS returns **at most ~100 items per feed**, so `maxArticlesPerFeed` cannot go above 100. For deeper
  history, schedule the actor (new items appear at the top) or use a news archive actor.
- `maxItems` counts **delivered** rows and stops the run; feeds already fetched may add nothing after the cap.
- Rows are **not de-duplicated across feeds**: the same article can appear in two queries, two topics and a geo
  feed. That is by design (each row records which feed found it) — dedupe on `googleNewsUrl` or `publisherUrl`
  if you merge feeds.
- `publisherUrl` resolution sends one extra Google request per article and is best-effort: when Google does not
  answer (or after 10 minutes of resolving) the row is still delivered with `googleNewsUrl` and
  `urlResolvedBy` telling you why. `resolveUrls: false` skips it entirely.
- Google's RSS descriptions normally contain no summary text, so `snippet` is usually `null`. Headlines keep
  Google's ` - <publisher>` suffix in `title`; the clean name is in the `publisher` field.
- Feed requests retry three times on 429/5xx with backoff. If Google starts throttling your scheduled runs,
  switch on `proxyConfiguration` (Apify Proxy) — plain HTTP measured clean on 15 November 2026: 25 article
  resolutions plus the feeds, no 429 and no 5xx.
- Google publishes these feeds for feed readers with no key, but its copyright notice restricts the feed "for
  the purpose of rendering Google News results within a personal feed reader". You are responsible for how you
  use the data and for Google's terms.

### Related actor

For brand, keyword and competitor monitoring over a **curated index of 350+ publisher news feeds** — including
Southeast Asian outlets that Google News surfaces late or not at all — use
[News Mentions API (subimpact/news-mentions-api)](https://apify.com/subimpact/news-mentions-api). It returns
publisher-native article rows with region, topic and language, and it is the better source when you need
publisher feeds directly rather than Google's ranking. This actor is the better source when you want Google
News search operators, Google's topic pages or an exact Google News edition.

### Run monitoring and privacy

If a run fails or times out, this Actor tells its developer the run ID and status, so we can fix problems fast. It never sends your input, your results or your account data.

# Actor input Schema

## `queries` (type: `array`):

Google News search queries, one feed each. Google's own search operators work: quotes for an exact phrase, site:reuters.com to restrict a publisher, when:7d or when:1h for recency, AND / OR / -term. Example: "electric vehicles" site:reuters.com when:7d

## `topics` (type: `array`):

Google News topic feeds: the same headlines Google News shows on its topic pages, each story with the cluster of articles covering it.

## `geos` (type: `array`):

Place names for Google News geo feeds, e.g. Malaysia, Penang, Singapore, London. Google only resolves places it knows for the chosen country, so a run with no matching place returns an Empty row (not charged).

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

Google interface locale, e.g. en-US, en-GB, en-MY, ms-MY, id, pt-BR, zh-CN. It selects the edition language of every feed and is copied to each row as language.

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

Two-letter country code for the Google News edition, e.g. US, MY, SG, GB, ID. Copied to each row as country. Together with the language it forms Google's ceid parameter (MY + en-MY -> MY:en).

## `maxArticlesPerFeed` (type: `integer`):

Rows taken from each feed, in the order Google ranks them. Google's RSS returns at most ~100 items per feed, so 100 means everything.

## `maxItems` (type: `integer`):

Hard cap on delivered article rows for the whole run. Counting stops at rows actually delivered, so a run never goes over the cap.

## `resolveUrls` (type: `boolean`):

Follow each news.google.com/rss/articles/<id> link through Google's public batchexecute endpoint to the real publisher URL. Costs one extra Google request per article and takes a few seconds per 100 rows; turn it off for a faster, cheaper metadata-only run (publisherUrl stays null, googleNewsUrl is always kept).

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

Optional. Plain HTTP works and is the default; switch on Apify Proxy if Google starts rate-limiting your runs or if you need a specific country's News edition.

## Actor input object example

```json
{
  "queries": [
    "malaysia economy"
  ],
  "topics": [],
  "geos": [],
  "language": "en-US",
  "country": "US",
  "maxArticlesPerFeed": 100,
  "maxItems": 300,
  "resolveUrls": true,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

One row per article: feedType/feed/feedUrl (which query, topic or place), position (Google's ranking), title, publisher, publisherUrl (real publisher link when resolved), googleNewsUrl, publishedAt (ISO 8601 UTC), snippet, sourceDomain, relatedArticles (the cluster Google groups around the story), language, country, scrapedAt, status (Success/Empty/Error — only Success rows are charged) and urlResolvedBy.

# 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 = {
    "queries": [
        "malaysia economy"
    ],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("subimpact/google-news-rss-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 = {
    "queries": ["malaysia economy"],
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("subimpact/google-news-rss-scraper").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 '{
  "queries": [
    "malaysia economy"
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call subimpact/google-news-rss-scraper --silent --output-dataset

```

## MCP server setup

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

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/MJQK9X65pFdJZkbk8/builds/uZGx8cZoDsueMWYtQ/openapi.json
