# Google News Scraper (`seemuapps/google-news-scraper`) Actor
Scrape Google News articles by keyword, topic, or top headlines - titles, real article URLs, sources, snippets, and publish dates.
- **URL**: https://apify.com/seemuapps/google-news-scraper.md
- **Developed by:** [Andrew](https://apify.com/seemuapps) (community)
- **Categories:** Lead generation, News, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $0.80 / 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.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use 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
Scrape Google News articles by keyword, topic, or top headlines — get titles, real publisher URLs, source names, snippets, and publish dates. No login, no API key, no proxies required.
### What you get
For each article, the scraper returns:
- **Title and real article URL** — Google News links are redirect URLs; the scraper resolves them to the publisher's actual page (`urlResolved` tells you when it succeeded)
- **Source name and source website** (e.g. "Reuters", `https://www.reuters.com`)
- **Publish date** in clean ISO 8601 format — ready for sorting and filtering
- **Snippet** — plain-text summary extracted from the feed
- **Related coverage** — when Google bundles related stories, you get an array of `{title, sourceName}` for each related article
- The **query or topic** each article came from, so you can run many searches in one go and keep results organized
- Results are deduplicated by URL across all queries — one clean row per article
- Export to JSON, CSV, Excel, or Google Sheets directly from the Apify console
### Use cases
- **News monitoring** — track breaking coverage of any keyword, company, or person and pipe it into alerts or dashboards
- **Brand mention tracking** — see every outlet writing about your brand (or a client's), with source names and timestamps
- **Trend detection** — schedule recurring runs on topic feeds (TECHNOLOGY, BUSINESS, SCIENCE …) and spot emerging stories early
- **AI / RAG news ingestion** — feed fresh, structured news articles with clean URLs and ISO dates into LLM pipelines and vector stores
- **Competitive intelligence** — combine `site:` operators and keyword queries to monitor competitors' press coverage and announcements
### How to use
1. Enter one or more **Search queries** — plain keywords or Google operators:
- `"artificial intelligence"` — exact phrase
- `tesla when:7d` — only articles from the last 7 days
- `site:reuters.com openai` — only articles from a specific outlet
2. And/or pick **Topics**: WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SCIENCE, SPORTS, HEALTH
3. Leave both empty to scrape the **top headlines** for your chosen country and language
4. Set **Language** (e.g. `en`, `de`, `pt-BR`) and **Country** (e.g. `US`, `GB`, `AU`) to pick the Google News edition
5. Set **Max Items** (0 = everything available; each feed returns up to ~100 articles)
6. Run the actor — results appear in the **Dataset** tab, one article per row
Tip: keep **Resolve real article URLs** enabled to get publisher URLs instead of news.google.com redirect links. Disable it for faster runs when the redirect URLs are good enough.
### Output format
Each dataset record:
```json
{
"query": "artificial intelligence",
"title": "How do young people feel about AI? 7 teens weigh in",
"url": "https://www.npr.org/2026/07/14/nx-s1-5863025/teens-artificial-intelligence-ai-school",
"urlResolved": true,
"sourceName": "NPR",
"sourceUrl": "https://www.npr.org",
"publishedAt": "2026-07-14T20:00:00.000Z",
"snippet": "How do young people feel about AI? 7 teens weigh in NPR",
"relatedArticles": [
{ "title": "Teens are using AI for homework help", "sourceName": "The Verge" }
]
}
````
# Actor input Schema
## `queries` (type: `array`):
Keyword searches to run against Google News. Supports Google search operators like site:reuters.com, quoted phrases, and when:7d (articles from the last 7 days). Leave empty (along with Topics) to scrape top headlines.
## `topics` (type: `array`):
Google News topic sections to scrape. Allowed values: WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SCIENCE, SPORTS, HEALTH. If both Queries and Topics are empty, the actor scrapes top headlines.
## `language` (type: `string`):
Language code for results (Google News 'hl' parameter), e.g. en, en-GB, de, fr, es, pt-BR, ja.
## `country` (type: `string`):
Country code for the news edition (Google News 'gl' parameter), e.g. US, GB, AU, DE, IN, BR.
## `maxItems` (type: `integer`):
Maximum number of articles to return across all queries and topics. Set 0 to return everything available (each feed returns up to ~100 articles).
## `resolveUrls` (type: `boolean`):
Google News feeds link to news.google.com redirect URLs. When enabled, the actor resolves each link to the publisher's real article URL. Disable for faster runs that keep the Google redirect URLs.
## Actor input object example
```json
{
"queries": [
"artificial intelligence"
],
"language": "en",
"country": "US",
"maxItems": 0,
"resolveUrls": true
}
```
# Actor output Schema
## `results` (type: `string`):
One record per article: query, title, url, urlResolved, sourceName, sourceUrl, publishedAt (ISO 8601), snippet, relatedArticles.
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"queries": [
"artificial intelligence"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("seemuapps/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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = { "queries": ["artificial intelligence"] }
# Run the Actor and wait for it to finish
run = client.actor("seemuapps/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 '{
"queries": [
"artificial intelligence"
]
}' |
apify call seemuapps/google-news-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=seemuapps/google-news-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Google News Scraper",
"description": "Scrape Google News articles by keyword, topic, or top headlines - titles, real article URLs, sources, snippets, and publish dates.",
"version": "1.0",
"x-build-id": "zDli7OSD84WxbkdZU"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/seemuapps~google-news-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-seemuapps-google-news-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/seemuapps~google-news-scraper/runs": {
"post": {
"operationId": "runs-sync-seemuapps-google-news-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/seemuapps~google-news-scraper/run-sync": {
"post": {
"operationId": "run-sync-seemuapps-google-news-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"queries": {
"title": "Search queries",
"type": "array",
"description": "Keyword searches to run against Google News. Supports Google search operators like site:reuters.com, quoted phrases, and when:7d (articles from the last 7 days). Leave empty (along with Topics) to scrape top headlines.",
"items": {
"type": "string"
}
},
"topics": {
"title": "Topics",
"type": "array",
"description": "Google News topic sections to scrape. Allowed values: WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SCIENCE, SPORTS, HEALTH. If both Queries and Topics are empty, the actor scrapes top headlines.",
"items": {
"type": "string"
}
},
"language": {
"title": "Language",
"type": "string",
"description": "Language code for results (Google News 'hl' parameter), e.g. en, en-GB, de, fr, es, pt-BR, ja.",
"default": "en"
},
"country": {
"title": "Country",
"type": "string",
"description": "Country code for the news edition (Google News 'gl' parameter), e.g. US, GB, AU, DE, IN, BR.",
"default": "US"
},
"maxItems": {
"title": "Max Items",
"minimum": 0,
"type": "integer",
"description": "Maximum number of articles to return across all queries and topics. Set 0 to return everything available (each feed returns up to ~100 articles).",
"default": 0
},
"resolveUrls": {
"title": "Resolve real article URLs",
"type": "boolean",
"description": "Google News feeds link to news.google.com redirect URLs. When enabled, the actor resolves each link to the publisher's real article URL. Disable for faster runs that keep the Google redirect URLs.",
"default": true
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```