# Google News Scraper: Headlines by Keyword, Topic & Language (`ai_admin/google-news-scraper`) Actor

Google News scraper and news API: articles by keyword, topic or site for any country and language (Ukrainian, Russian, English and 40+ editions) with direct publisher URLs, image, author and full text in one price. Date ranges beyond the 100-article limit. No proxy, no API key.

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

## Pricing

from $2.50 / 1,000 news articles

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 Scraper: Headlines by Keyword, Topic & Language

Get Google News articles as clean JSON: by keyword, by topic or by publisher site, in any Google News edition -
**Ukrainian, Russian, English, German, French, Spanish, Polish, Japanese and 40+ more**. One record per article:
headline, publisher, publication time, the **direct URL on the publisher's site** and, if you want, the article's
image, description, author and **full text** - all for one price per article.

- **Search like on Google News:** `"exact phrase"`, `OR`, `-exclude`, `site:reuters.com`, `intitle:word`.
- **Topic headlines:** TOP, WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SCIENCE, SPORTS, HEALTH.
- **Several countries and languages in one run:** e.g. `UA:uk`, `UA:ru` and `US:en` for the same queries - compare
  how a story is covered in each market.
- **More than 100 articles per query:** Google News shows at most 100 per search; give a date range (or a time period)
  and the Actor reads it day by day, up to 5,000 articles per query, without duplicates.
- **Direct publisher URLs** (on by default): `url` is the article on the publisher's site, not a Google News
  redirect; `ampUrl` too when the site has one.
- **Article details and full text** (optional): image, description, author, page date, site name, word count and the
  clean article text without menus and ads - ready for AI, RAG, summaries and sentiment.
- **Related coverage:** in topic headlines most stories come with the other outlets that wrote about them (Google
  News adds these story clusters to topic feeds; search results rarely have them).
- No proxy and no API key needed; failed feeds are not charged.

Use it for media monitoring and PR, brand and competitor mentions, market and crypto news, news datasets for AI and
RAG, and daily digests (schedule it every morning).

### Why this Actor

| | This Actor | Typical alternatives in the Apify Store (Nov 2026) |
|---|---|---|
| **Languages** | Any edition, several per run (UA:uk + UA:ru + US:en…) | One region per run |
| **Volume** | Up to 5,000 articles per query by reading the date range day by day | Often capped at 100 |
| **Story context** | Topic headlines with related coverage from other outlets (story clusters) | Single article only |
| **Publisher URL + article page + text** | All included: **$3 per 1,000** (paid plans), $2.50 on Gold and higher | Leaders charge add-ons: $3.30-4 per 1,000 in total, plus start fees of $5 per 1,000 runs |
| **Full text for AI** | Included, clean text without boilerplate | Often an extra fee per article page |
| **Start fee** | Apify's minimum ($0.05 per 1,000 runs) - cheap for frequent small runs | Often $5 per 1,000 runs, some $90 |

### Input

```json
{
  "queries": ["Укренерго", "\"electric vehicles\" -Tesla"],
  "topics": ["BUSINESS"],
  "editions": ["UA:uk", "US:en"],
  "timeframe": "7d",
  "maxArticlesPerQuery": 100,
  "includeRelatedCoverage": true,
  "resolveUrls": true,
  "articleDetails": false,
  "fullText": false
}
```

For a fixed period use `"dateFrom": "2026-11-01", "dateTo": "2026-11-15"` instead of `timeframe`.

Two ready-made inputs that show every field (articles from sites open to automated visitors):

```json
{"queries": ["штучний інтелект"], "editions": ["UA:uk"], "timeframe": "7d", "maxArticlesPerQuery": 10, "fullText": true}
```

```json
{"queries": ["artificial intelligence (site:theguardian.com OR site:bbc.com OR site:npr.org)"], "editions": ["US:en"],
 "timeframe": "7d", "maxArticlesPerQuery": 10, "fullText": true}
```

### Output

```json
{
  "query": "electric vehicles",
  "edition": "US:en",
  "position": 1,
  "title": "Automakers bet on cheaper batteries for 2027 models",
  "source": "Example News",
  "sourceUrl": "https://www.example.com",
  "sourceDomain": "example.com",
  "publishedAt": "2026-11-14T09:30:00Z",
  "googleNewsUrl": "https://news.google.com/rss/articles/CBMi...?oc=5",
  "url": "https://www.example.com/business/cheaper-batteries-2027",
  "ampUrl": "https://www.example.com/amp/business/cheaper-batteries-2027",
  "imageUrl": "https://www.example.com/images/batteries.jpg",
  "description": "Battery costs keep falling, and carmakers plan cheaper models.",
  "author": "Jane Doe",
  "pageDate": "2026-11-14",
  "siteName": "Example News",
  "wordCount": 812,
  "text": "Carmakers are betting that cheaper batteries...",
  "articleId": "CBMi...",
  "relatedCoverage": [
    {"title": "Battery prices fall again", "source": "Other Daily", "googleNewsUrl": "https://news.google.com/rss/articles/..."}
  ]
}
```

(Values above are illustrative.) `imageUrl` ... `text` appear with `articleDetails` / `fullText`. If a link or a
page cannot be read, the article is still returned with `urlError` or `detailsError` explaining why.

### Pricing

| Event | Free plan | Paid plans | What counts |
|---|---|---|---|
| `article` | $3.50 per 1,000 | **$3 per 1,000** (Bronze, Silver), **$2.50** (Gold and higher) | one article with its publisher URL, details and text |

Plus Apify's standard start fee of $0.05 per 1,000 runs. Duplicates across queries are removed before charging, and
the run stops before it would exceed your maximum charge per run.

### Related Actors

- [Video Transcript & Translation](https://apify.com/ai_admin/social-video-transcript) - YouTube, TikTok, Reels to text
- [Document to Markdown for AI](https://apify.com/ai_admin/document-to-markdown) - PDFs and Office files to Markdown
- [Website Screenshot & URL/HTML to PDF](https://apify.com/ai_admin/website-screenshot) - capture the article pages

Open source: [github.com/AndriyVK/-apify-document-tools](https://github.com/AndriyVK/-apify-document-tools)

### Use with AI agents and code

- **MCP (Claude, Cursor, VS Code, any MCP client):** add `https://mcp.apify.com?tools=ai_admin/google-news-scraper` as an
  MCP server - the agent gets one tool with this Actor's input schema and pays per use through your Apify account.
- **One HTTP call that returns the results:**

```bash
curl -X POST "https://api.apify.com/v2/acts/ai_admin~google-news-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"queries": ["artificial intelligence"], "editions": ["US:en"], "timeframe": "1d"}'
```

### Limits

- Some publisher sites block automated visitors or have paywalls: then `detailsError` says so and the article comes
  without details (its publisher URL is still there). Measured on Apify 16.11.2026: publisher URLs for 100% of
  articles; full text for 27 of 30 Ukrainian, 28 of 30 Russian-language and 39 of 50 English articles (the rest were
  sites that refuse automated visitors, such as some large paywalled outlets).
- Article details make runs slower (one page per article); leave them off when you only need headlines and URLs.
- `relatedCoverage` is filled when Google News groups a story with other outlets: usually in topic headlines, rarely
  in search results (then it is an empty list).
- Google decides which articles a search returns: recent days give up to 100 articles per query per day, older days
  fewer (Google keeps a smaller sample of them), so long ranges return less than days x 100.
- Publication times are as Google News reports them (UTC).

# Actor input Schema

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

Keywords as in Google News search. Operators work: "exact phrase", OR, -exclude, site:reuters.com, intitle:word.

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

Optional topic headlines: TOP, WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SCIENCE, SPORTS, HEALTH. Up to 100 articles each.

## `editions` (type: `array`):

Google News editions as COUNTRY:language, e.g. US:en, GB:en, UA:uk, UA:ru, DE:de, FR:fr, ES:es, IT:it, PL:pl, BR:pt-419, IN:en, JP:ja. Several editions run the same queries in each.

## `timeframe` (type: `string`):

Only articles from the last hour, day, 7 days, 30 days or year. Ignored when dates are set.

## `dateFrom` (type: `string`):

First day (inclusive), e.g. 2026-11-01 or a relative "7 days".

## `dateTo` (type: `string`):

Last day (inclusive). Empty means today.

## `maxArticlesPerQuery` (type: `integer`):

Google News shows up to 100 articles per search. Above 100, the date range (or time period, 30 days by default) is read day by day to collect more.

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

Turn Google News links into the direct URL of the article on the publisher's site (url, plus ampUrl when there is one). Included in the article price.

## `articleDetails` (type: `boolean`):

Open each article on the publisher's site and add its image, description, author, page date, site name and word count. Included in the article price; slower.

## `fullText` (type: `boolean`):

Also add the clean article text (boilerplate removed), ready for AI, RAG and summaries. Included in the article price.

## `includeRelatedCoverage` (type: `boolean`):

Add other outlets covering the same story (title, source, link) when Google News groups them: usually in topic headlines, rarely in search results.

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

Not needed normally. Turn on only if Google starts limiting requests for very large runs.

## Actor input object example

```json
{
  "queries": [
    "artificial intelligence"
  ],
  "editions": [
    "US:en"
  ],
  "timeframe": "",
  "maxArticlesPerQuery": 100,
  "resolveUrls": true,
  "articleDetails": false,
  "fullText": false,
  "includeRelatedCoverage": true,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

Dataset items: title, source, publishedAt, googleNewsUrl, relatedCoverage.

# 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": [
        "artificial intelligence"
    ],
    "editions": [
        "US:en"
    ],
    "maxArticlesPerQuery": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("ai_admin/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 = {
    "queries": ["artificial intelligence"],
    "editions": ["US:en"],
    "maxArticlesPerQuery": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("ai_admin/google-news-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": [
    "artificial intelligence"
  ],
  "editions": [
    "US:en"
  ],
  "maxArticlesPerQuery": 100
}' |
apify call ai_admin/google-news-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,ai_admin/google-news-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/xFyXgsGKGKPeM2kU2/builds/V1zuv9TrUCaMfVyLZ/openapi.json
