Google News Scraper (Apify)

Search Google News headlines by keyword, company, brand or topic. Filter by date range and country edition. Headlines, sources, dates and links as JSON or CSV.

Hosted MCP Server

npx add-mcp 'https://mcp.apify.com/?tools=monkey.d.scraping/google-news-scraper-lite'

Installs into Claude Code, Codex, Cursor and more

Documentation

Google News Scraper — Headlines & CSV Export (monkey.d.scraping/google-news-scraper-lite) Actor

Search Google News headlines by keyword, company, brand, or topic. Filter by date range and country edition. Export headlines, sources, dates, and links to CSV or JSON, with optional direct publisher URLs. $0.20/1K records + $0.0015/run. No full article text.

Pricing

from $0.20 / 1,000 news records

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 section below.

Each client library has reference documentation the quickstart does not restate: JavaScript/TypeScript (npm install apify-client) and Python (pip install apify-client).

README

Google News Scraper — Company News & Article URLs

Search Google News for companies, brands, competitors and topics, filtered by country edition and publication date. Export article headlines, publishers, dates, Google News links and matching searches to CSV, Excel or JSON. Add direct article URLs, publisher descriptions and image URLs when you need an enriched press review.

Use this Google News scraper for brand monitoring, competitor news tracking, media monitoring and historical news research across 13 country/language editions. Custom date ranges can span multiple years, with up to 300 articles per keyword and 20 keywords per run. No Google News API key is required; programmatic Apify calls use your Apify token.

Price: $0.20 per 1,000 saved news records + $0.0015 per run start, with platform usage included at 128 MB. Every option has the same result price. Check the current Pricing tab before running.

Try a small sample first

Try 10 news headlines →

Open the example, choose Try for free to copy it into your Apify account, and replace artificial intelligence with your topic. It returns up to 10 headlines, publishers, dates and Google News links, ready to export as CSV or JSON.

At the current rates and saved 128 MB setting, 10 records cost $0.0035 including startup and run platform usage; a run that finds no articles costs $0.0015. The saved $0.01 spending cap is a ceiling, not a fixed fee. “Try for free” is Apify’s button label; the run uses your account credit or balance.

Need direct publisher links? Use the brand and competitor example, with up to 20 records for $0.0055. For descriptions and images, see all three examples.

No mode to choose: custom dates, more articles and publisher details turn on as soon as you fill in the matching field. Start with ten articles to see the coverage for your keyword.

Automate your news sheet: Google News to Google Sheets with n8n, with step-by-step setup and an importable workflow.

What can you collect?

NeedChooseOutput
Recent news headlinesPast 24 hours, 7 days or 30 daysHeadlines, publishers, publication dates and Google News links
Publisher article URLsEnable Get direct article linksVerified direct article URLs
Historical news by dateFill in From date (Custom dates is selected automatically)Matching news across the whole range, searched in date windows
More than 100 articles per keywordMaximum articles per keyword above 100Up to 300 articles per keyword, with more date windows searched automatically
Descriptions and imagesEnable Get publisher descriptions and imagesPublisher descriptions and image URLs, with a status for each record

Common questions

Can I search Google News across multiple years? Yes. Fill in From date; Through date defaults to today. Ranges can cover up to 3,660 days; a future end date is set to today.

Does this include full article text? No. Records contain headlines, publishers, dates and links; the optional enrichment adds publisher descriptions and image URLs. Fields a publisher does not provide stay empty.

How much does a test cost? Up to 10 saved records cost $0.0035 including startup; up to 300 cost $0.0615. Platform usage at 128 MB is included. A run that finds no articles costs $0.0015. The record fee is the same with or without optional publisher details.

Is this the official Google News API? No. This is an independent Actor accessed through the Apify API. Export its dataset or use the n8n workflow below to update Google Sheets.

Quick start

  1. Replace the example keyword with your brand, company or topic.
  2. Keep Maximum articles per keyword at 10 for your first test.
  3. Choose the country edition and News from period, set your run spending cap, then start the Actor.
  4. Open the News headlines dataset view, check Collection summary, and export the dataset as CSV or Excel.

The four main fields are enough for a headlines search. Open Optional: article links, descriptions and images and enable Get direct article links when your workflow needs the publisher URL.

{
  "queries": ["Microsoft"],
  "edition": "en-US",
  "period": "week",
  "maxItemsPerQuery": 10,
  "resolveArticleUrls": false
}

The first-run Console example uses the United States / English edition and 10 articles. API requests that omit edition or maxItemsPerQuery use Italy / Italian and 50 articles per keyword. Keep these fields explicit to reproduce the example. Set resolveArticleUrls to true when you need direct publisher links.

Choose from the 13 supported country/language editions listed below. The edition sets the Google News localization; publishers and headline languages come from the source.

Brand and competitor news: multiple searches, one sheet

For a first press review, collect two related searches in one run. Paste this input in Console, replace the example brands, and set Maximum cost per run to $0.01 in run options:

{
  "queries": ["Microsoft", "OpenAI"],
  "edition": "en-US",
  "period": "week",
  "maxItemsPerQuery": 10,
  "resolveArticleUrls": false
}

This requests up to 10 articles per search, at most 20 unique saved records: up to $0.0055 including startup at 128 MB. The $0.01 cap is a ceiling, not the expected charge. Articles shared by both searches are saved and charged once.

In News headlines, review the headline, publication date, publisher, All matching searches (matchedQueries) and Google News link. Export CSV or Excel for a one-off review. To keep a sheet updated, use the existing n8n workflow: put both queries in its Configuration node and set maxTotalChargeUsd to 0.01. Its default $0.005 cap is sized for one keyword.

The same Google News article ID is saved once per run and retains all matching searches. For example, one row may match both Microsoft and OpenAI: it counts as one article and one record charge, and contributes to both search counts. Separate articles about the same story stay separate rows.

For recurring use, the workflow updates existing IDs and appends new ones. Each Actor run collects and charges matching articles again, including those already in your sheet. Validate one manual run before setting up your own schedule.

Choose the result you need

Your goalSettingWhat to expect
Review headlines in a spreadsheetLeave Get direct article links offHeadlines, publishers, dates and Google News links; a small first run
Link your dashboard to publisher articlesEnable Get direct article linksThe same news records, with a verified publisher URL in articleUrl
Keep a reusable news sheetFollow the n8n guideA workflow that stores and updates rows across runs

Every run returns headlines and Google News links; direct links, descriptions and image URLs are optional. Sentiment and alerts are not part of this Actor. All options cost the same per saved news record; direct links and publisher details take additional time.

More articles and publisher metadata

Enable Search more date windows to split the period into smaller date ranges and find more articles per keyword. Above 100 articles per keyword it is enabled automatically, the log shows a note and RUN_SUMMARY.expandCoverageAutoEnabled is true. Articles repeated across windows or keywords are saved once. The maximum is 300 articles per keyword.

{"queries":["Microsoft"],"edition":"en-US","period":"week","expandCoverage":true,"maxItemsPerQuery":300}

To collect publisher descriptions and images, enable enrichArticles. It turns on direct links automatically and processes the collected records, up to 20 keywords × 300 articles, within the time budget and spending cap. Each record reports enrichmentStatus and publisherFetchedAt; RUN_SUMMARY counts descriptions and images found. The record fee is the same whether or not a publisher provides these fields.

{"queries":["Microsoft"],"edition":"en-US","period":"week","maxItemsPerQuery":50,"enrichArticles":true}

Supported editions: Italy/Italian, US/English, UK/English, Germany/German, France/French, Spain/Spanish, Canada/English, Canada/French, Australia/English, India/English, Brazil/Portuguese, Netherlands/Dutch and Japan/Japanese.

Three copy-and-paste starting points

Quick headlines — 10 recent results, up to $0.0035 including startup:

{"queries":["Microsoft"],"edition":"en-US","period":"week","maxItemsPerQuery":10}

Enriched press review — up to 300 records, up to $0.0615 including startup:

{"queries":["Microsoft"],"edition":"en-US","period":"week","maxItemsPerQuery":300,"expandCoverage":true,"enrichArticles":true,"processingBudgetSeconds":900}

Historical research — inclusive custom dates, searched window by window:

{"queries":["\"Mario Calabresi\""],"edition":"it-IT","period":"custom","dateFrom":"2025-01-01","dateTo":"2026-10-17","maxItemsPerQuery":300,"expandCoverage":true,"resolveArticleUrls":false}

For the two 300-record examples, set a spending cap of $0.07 or higher to allow the full requested output. The default run timeout of 3,600 seconds covers processing budgets up to 3,570 seconds; if a saved task uses a shorter timeout, raise it in its run options. No schedule is created automatically.

Precise names and optional headline filters

Broad queries such as Calabresi Milano can match news about other people. Start with "Mario Calabresi" for an exact name, and keep wider context searches separate if you want both kinds of coverage. includeTitleTerms: ["Mario Calabresi"] keeps only headlines containing that phrase; excludeTitleTerms: ["Lotta Continua"] removes matching headlines. Filters match literal, case-insensitive text in the headline and are off by default. filteredByTitleOccurrences counts filtered observations across date windows.

Read the per-keyword summary

Open Results and limits by query (QUERY_SUMMARY) for each keyword's article count, whether the article maximum was reached, the date windows searched and a suggested next step. RUN_SUMMARY.queryResults contains the same details. oldestArticleAt and newestArticleAt are the dates of the oldest and newest returned articles. itemLimitReached means the configured maximum was reached; omittedForItemLimit counts collected articles left out by that maximum. Historical windows are searched newest first. To go deeper into a specific period, narrow the dates and run it separately.

Publisher details are cached by exact article URL, so the same page is read once per run. publisherDescriptionsAvailable and publisherImagesAvailable count the two fields separately; enriched means at least one of them was found.

processingBudgetSeconds sets the time for collection, links and publisher details; results are saved before the run timeout. complete reports whether the requested output was fully processed. Review it before importing into another system.

Input validation lists every issue in one message, naming the field to change.

Measured example: coverage, speed and price

Observed on 16 October 2026, version 0.1.19, at 128 MB, on sample runs of this Actor.

Input: Microsoft, en-US, past weekUnique recordsRuntimeResult detailsCustomer price at the listed rate
Headlines, maximum 1001004.24 sHeadlines, publishers, dates and Google News links$0.0215
More date windows, maximum 3003008.79 s265 repeated records removed across date windows$0.0615
Publisher metadata, maximum 505028.73 s50 direct URLs; 36 records with both description and image$0.0115

The 300-record sample kept 98 of the 100 baseline IDs and added 202. Results change between runs as new articles are published.

Reproduce it: use the two JSON examples above. For the baseline use queries: ["Microsoft"], edition: "en-US", period: "week", maxItemsPerQuery: 100, with direct links disabled. Set API run options to memory=128, timeout=120, and a maximum charge of $0.03, $0.07 or $0.02 respectively. Runtime is the Apify run duration; prices include startup and saved records, not a monthly Apify subscription.

Ready-to-run example tasks

Open an example below and choose Try for free to create your own task in Apify Console, then replace its keywords with your own. All three use the United States / English edition and the past 7 days.

Example taskWhat you getMaximum example cost per run
Monitor brand and competitor newsMicrosoft and Google headlines, publishers, dates and verified direct article links; up to 20 records$0.0055
Try Google News: 10 AI headlinesArtificial intelligence headlines, publishers, dates and Google News links; up to 10 records$0.0035
Get article descriptions and imagesUp to 10 Microsoft news records with direct URLs, publisher descriptions and images, and a status for each field$0.0035

All three saved examples use a $0.01 run spending cap. The cap is a ceiling, not the example charge. Example costs include startup and platform usage, and each run charges only the records it saves. Repeated runs collect matching articles again. Changing the keywords or record limits changes the results and the cost.

What can you use it for?

  • Brand and competitor monitoring: collect recent mentions of companies or products for a review dashboard.
  • Media research: compare headlines and publishers covering the same topic.
  • Market intelligence: follow industry, technology or economic news in a selected edition.
  • News automation: export structured records or pass them to the next step of an API workflow.

Each run deduplicates articles within the run. To keep one row per article across runs, use the n8n workflow below, which updates rows by article ID.

Check news quality before importing

If a direct link or publisher detail is not available for some records, the run still succeeds: headlines are kept and RUN_SUMMARY.warnings explains what is missing. For example, 928 saved articles with 927 resolved links make a successful run with one warning; use googleNewsUrl for the remaining article. collectionComplete reports whether collection finished within the time and spending limits, and complete is true when every requested link and detail was also processed.

Temporary source errors are retried automatically, up to three times within the processing time budget; RUN_SUMMARY.sourceRetries counts the new attempts. Set strictMode: true if you prefer the run to fail whenever requested links or details are incomplete. The supplied n8n workflow requires complete: true before writing to Google Sheets. Review the saved dataset before rerunning to avoid repeat charges.

Records without a valid date or article identifier are not saved, and complete is then false. A search with no matching articles is a successful, empty result.

Output

FieldMeaning
titleHeadline supplied by Google News
publisherSource publication
publishedAtPublication timestamp supplied by Google News, normalized to UTC
articleUrlVerified publisher article link when requested; otherwise null
articleUrlResolvedWhether the direct article link was verified
articleUrlStatusStatus of the direct article link
googleNewsUrlOriginal Google News article link
publisherHomepagePublisher homepage, separate from the article link
matchedQueriesKeywords that matched the same news item in this run
collectedAtCollection time in UTC

Example output shape (illustrative values):

{
  "title": "Example company announces a new product",
  "publisher": "Example Publisher",
  "publishedAt": "2026-10-10T08:00:00+00:00",
  "articleUrl": "https://publisher.example/news/new-product",
  "articleUrlResolved": true,
  "articleUrlStatus": "resolved",
  "matchedQueries": ["example company"],
  "edition": "en-US"
}

With direct links disabled, articleUrl is null and articleUrlStatus is not_requested. The original googleNewsUrl is always included. With direct links enabled, results are saved in small batches as links are processed, so arrival order can differ from publication order. Sort by publishedAt if your workflow needs newest-first output.

On very large runs, publisher links can become temporarily unavailable. The Actor then waits and tries again, and the wait is counted in articleUrlWaits and articleUrlWaitSeconds in RUN_SUMMARY. If links stay unavailable, the remaining articles are saved with articleUrlStatus set to not_attempted_rate_limit and keep their googleNewsUrl; run the same dates again later to get those links.

Search examples

GoalKeyword or topic
Follow a brandMicrosoft
Follow a company with several words"example company"
Focus on a publicationbitcoin site:reuters.com
Follow an industry topicrenewable energy

Use News from for the past 24 hours, 7 days or 30 days. For other periods choose Custom dates, or simply fill in dateFrom and optionally dateTo: dates are inclusive in UTC, from 1970 onward, up to 3,660 days, and a future end date is set to today. Long ranges are searched in consecutive date windows; with expandCoverage they are searched about one month at a time, which finds more articles over long periods. Put dates in these fields rather than in the keyword: when:, before: and after: operators are not accepted in keywords. The number of articles depends on how many match your keyword in Google News.

Run size and timing

Runs accept up to 20 keywords and up to 300 articles per keyword; above 100, expandCoverage is enabled automatically. Direct links and publisher details are processed for all collected records within processingBudgetSeconds (default 900, range 60–3600). Start with a small run to see the volume and time for your keywords before requesting thousands of records.

A direct link is kept only when its publisher matches the source shown in Google News, so articleUrl always points to the attributed publisher. Dates outside the selected period are filtered out. Image URLs are returned as links; image files are not downloaded. No API key or login is required.

Export and integrations

Use the Apify dataset to export JSON, CSV or Excel. An API workflow, n8n or Make can start the Actor and read its dataset using their Apify integration or HTTP modules. Use the returned fields for your dashboard or processing step; sentiment analysis and summaries are not included in this Actor.

Frequently asked questions

Can I use this as a Google News API? Yes. Start the Actor through the Apify API and read its dataset. This is an independent scraper, not an official Google API.

Can it monitor brand mentions automatically? Schedule repeated runs on Apify and use the dataset in your workflow. Each run collects matching articles again; the n8n workflow below updates existing rows by article ID.

Does it return direct article URLs? Yes, when requested: verified publisher links are returned in articleUrl, and articleUrlStatus reports the status of each link.

Does the date filter check article content? It uses the publication date supplied by Google News.

Is this Google Search scraping? It collects Google News results. It does not collect Google.com organic search results.

What does it cost? $0.20 per 1,000 news records saved to the dataset, plus $0.0015 per run start. Platform usage is included. All options have the same result price, and the record fee applies to each saved news record with or without optional publisher details. The startup fee applies to every run, including runs with no results.

Can I cap the cost? Set Maximum cost per run in Apify Console, or maxTotalChargeUsd through the API. The minimum run budget is $0.0017. A $0.0025 budget covers the startup fee and up to five news records. The Actor collects within the available budget and stops when it is reached, keeping the records already saved. Charges apply only to records saved within the budget.

Can I choose exact start and end dates?

Yes. Fill in dateFrom and optionally dateTo (default today); Custom dates is selected automatically. Both dates are inclusive in UTC, up to 3,660 days, from 1970 onward; a future end date is set to today. Long ranges are searched in consecutive date windows, newest first. Enable expandCoverage to search long ranges about one month at a time and split busy periods further, which finds more articles per keyword; the run stops at the article maximum or the time budget.

Does the selected country restrict every publisher to that country?

No. Country and language select a Google News edition. Publishers and headline languages come from the source.

How do I report missing or unresolved data?

Open the Issues tab with your run ID, a non-sensitive query, the edition and the expected result. Include RUN_SUMMARY and the articleUrlStatus values you see. A publisher homepage is not a substitute for an article URL.

Price examples

Delivered news recordsTotal run charge
0$0.0015
10$0.0035
100$0.0215
200$0.0415

These are charges for one run at 128 MB. The price is the same across Apify plans; Free-plan users spend their available Apify credits. Repeated scheduled runs incur a startup fee each time.

Google News to Google Sheets with n8n

Build a brand monitoring sheet with Google News headlines, publishers, publication dates and article links. This workflow uses Google News Scraper and built-in n8n nodes; you do not need a community node or a Google News API key.

Start with Microsoft, United States, past week, up to 10 articles. The Actor charge is at most $0.0035 per run at the current list price, with a $0.005 run spending cap. The workflow runs manually until you choose to add a schedule.

What you need

  • An Apify account with available credits and an API token.
  • An n8n instance with HTTP Request, Code and Google Sheets nodes. Import and execution were verified with n8n 2.42.6; on older versions, update node versions or mapping if prompted.
  • A Google Sheet you can edit and a Google Sheets OAuth2 credential configured in n8n. Follow n8n’s Google Sheets credential guide.

1. Prepare the sheet

Create a tab named News. Paste these tab-separated column names into cell A1, all on the first row:

id	title	publisher	publishedAt	articleUrl	googleNewsUrl	matchedQueries	edition	collectedAt	articleUrlStatus

Keep the headers exactly as shown. Keep id as text and unique. Avoid blank rows inside the table and concurrent workflows writing to this tab. The Google Sheets credential must have edit access to this document.

Your spreadsheet ID is the part between /d/ and /edit in its URL. For example, in https://docs.google.com/spreadsheets/d/YOUR_ID/edit, use YOUR_ID.

2. Import the workflow

Save the supplied google-news-to-google-sheets.n8n.json file and select Import from File in n8n. On the Actor’s public README, the same workflow is available in the Importable workflow JSON section: copy the JSON, save it as a .json file, and import it. n8n import instructions.

Open Configuration and replace PASTE_YOUR_SPREADSHEET_ID with your document ID. You can edit keywords, country, time period and record limit in this single node. Keep the default configuration for your first test:

{
  "queries": ["Microsoft"],
  "edition": "en-US",
  "period": "week",
  "maxItemsPerQuery": 10,
  "resolveArticleUrls": false,
  "maxTotalChargeUsd": 0.005,
  "spreadsheetId": "PASTE_YOUR_SPREADSHEET_ID",
  "sheetName": "News"
}

This workflow collects headlines for the rolling periods; for publisher details or custom dates, run the Actor directly. Choose the Google News edition explicitly: en-US, en-GB, it-IT, de-DE, fr-FR or es-ES. Period accepts day, week or month. The workflow checks your configuration before starting a paid run.

3. Connect credentials

In any of the four HTTP Request nodes, create a Bearer Auth credential. Enter your Apify token in the token field, without adding a Bearer prefix. Select this same credential in Start Actor, Wait for Run, Get Run Summary and Get Dataset Items.

Keep the token in n8n credentials; do not paste it into the workflow JSON, a query string or the Configuration node. Apify API authentication.

In Save News to Google Sheets, select your Google Sheets OAuth2 credential. Verify these settings:

SettingValue
OperationAppend or Update Row
DocumentID from Configuration
SheetNews, or the name from Configuration
MappingMap Automatically
Column to match onid
Cell formatRAW

If the editor asks you to refresh column mappings, refresh them after selecting the document and tab, then keep id as the matching column. RAW stores strings as data, including headlines that start with an equals sign. Google Sheets node operations.

4. Run a first test

Click Execute Workflow. The flow:

Manual run → check configuration → run Actor → verify complete output → map news → append or update rows by article ID.

The default example returns up to 10 records, depending on how many articles match. Publication dates and collection timestamps remain ISO strings in the sheet. matchedQueries is flattened into a text field.

With direct links disabled, articleUrl is empty and googleNewsUrl is your news link. Enable resolveArticleUrls if you need verified publisher article URLs. This takes longer; the sample workflow keeps a 200-requested-record limit and a 120-second run timeout, while the Actor itself supports larger inputs with a longer time budget. The workflow writes to the sheet only when every requested link was processed.

The Actor deduplicates overlapping queries within one run. The sheet additionally matches id across runs: existing IDs are updated, new IDs are appended, and each run's Actor charges still apply. Metadata and matched queries for an existing row are replaced by the latest run’s values, so the sheet always shows the current state.

Costs and scheduling

At the current list price, the Actor charges $0.0015 per start + $0.0002 per saved news record, including Actor platform usage at the prescribed 128 MB. The startup fee also applies when no articles are returned. n8n hosting and any separate storage/read/transfer charges are outside this estimate; check current pricing before enabling a schedule.

ConfigurationMaximum Actor charge per run30 runs, one per day
1 keyword × 10 records$0.0035$0.105
2 keywords × 10 records$0.0055$0.165
1 keyword × 100 records$0.0215$0.645

Set maxTotalChargeUsd at least as high as the configured maximum: 0.0015 + 0.0002 × keywords × maxItemsPerQuery. For two keywords with 10 articles each, a cap of $0.01 is sufficient. Overlapping queries reduce the saved count and charge. The default $0.005 cap covers the default single-keyword example.

After one successful manual run, you can replace the Manual Trigger with a Schedule Trigger, choose your timezone and run once daily. Publish/activate only when you are ready for repeated charges. The supplied workflow is inactive and contains no schedule.

Errors and recovery

  • Configuration error: no Actor is started. Fix the document ID, input or spending cap first.
  • Run is RUNNING/READY: the two API calls wait up to 60 seconds each. Open the given run ID in Apify Console. If it is still running, wait for completion and retrieve that run’s outputs; do not retry Start Actor just to download them.
  • FAILED, TIMED-OUT or ABORTED: inspect the run log and RUN_SUMMARY; the workflow stops before writing to Sheets. The start fee and records already saved are charged.
  • Budget reached before the end: the workflow stops instead of exporting a shorter set. Check the summary, then retry with a higher cap if you want the full output.
  • No results: a complete empty run leaves the sheet unchanged.
  • Google Sheets permission/header error: fix access or headers. Reuse the successful run’s dataset rather than launching another paid run. Reprocessing the same dataset with matching id updates existing rows instead of adding copies, provided the sheet has unique IDs and no concurrent writer.
  • Network error on Start Actor: automatic retries are disabled for this request. Check whether Apify created a run before launching another one. Read requests retry automatically up to three times.

Validation scope

The default input was run against the released Apify Actor on 10 October 2026: 10 records, complete: true. The importable JSON was imported into n8n 2.42.6 and executed locally with those real output shapes. Tests cover the official Google Sheets node logic for append, update on a repeat run and RAW value handling, and check that failed or pending runs, budget-limited output, duplicate IDs and an insufficient spending cap are stopped before writing. No token, credential ID, sheet ID or customer data is included in the template.

More ready-to-run monitoring examples

Use caseExample
Track brands and competitorsMicrosoft and Google news
Follow AI industry headlinesArtificial intelligence news
Try publisher metadata separately from this workflowArticle descriptions and images

For search interest over time, see Google Trends Keyword History. For public-channel updates, see Telegram New Posts Monitor. These are separate Actors with their own pricing.

Importable workflow JSON

Copy the JSON below into a .json file and import it in n8n.

{
  "name": "Google News to Google Sheets — budget-capped brand monitoring",
  "nodes": [
    {
      "id": "news-1",
      "name": "Manual Trigger",
      "type": "n8n-nodes-base.manualTrigger",
      "typeVersion": 1,
      "position": [
        0,
        200
      ],
      "parameters": {}
    },
    {
      "id": "news-2",
      "name": "Configuration",
      "type": "n8n-nodes-base.set",
      "typeVersion": 3.4,
      "position": [
        240,
        200
      ],
      "parameters": {
        "mode": "raw",
        "jsonOutput": "{\n  \"queries\": [\n    \"Microsoft\"\n  ],\n  \"edition\": \"en-US\",\n  \"period\": \"week\",\n  \"maxItemsPerQuery\": 10,\n  \"resolveArticleUrls\": false,\n  \"maxTotalChargeUsd\": 0.005,\n  \"spreadsheetId\": \"PASTE_YOUR_SPREADSHEET_ID\",\n  \"sheetName\": \"News\"\n}",
        "options": {}
      },
      "notes": "Edit queries and spreadsheetId here. Default: at most 10 records, $0.005 run cap, US edition. No schedule is enabled.",
      "notesInFlow": true
    },
    {
      "id": "news-3",
      "name": "Validate Configuration",
      "type": "n8n-nodes-base.code",
      "typeVersion": 2,
      "position": [
        480,
        200
      ],
      "parameters": {
        "jsCode": "const c = $input.first().json;\nif (!c.spreadsheetId || c.spreadsheetId === 'PASTE_YOUR_SPREADSHEET_ID') throw new Error('Set spreadsheetId in Configuration before running.');\nif (!Array.isArray(c.queries) || !c.queries.length || c.queries.length > 20 || c.queries.some(q => typeof q !== 'string' || !q.trim())) throw new Error('Provide 1–20 non-empty queries.');\nif (!Number.isInteger(c.maxItemsPerQuery) || c.maxItemsPerQuery < 1 || c.maxItemsPerQuery > 100) throw new Error('maxItemsPerQuery must be 1–100.');\nif (typeof c.resolveArticleUrls !== 'boolean') throw new Error('resolveArticleUrls must be true or false.');\nif (!['en-US','en-GB','it-IT','de-DE','fr-FR','es-ES'].includes(c.edition) || !['day','week','month'].includes(c.period)) throw new Error('Choose a supported edition and period.');\nif (!Number.isFinite(c.maxTotalChargeUsd) || c.maxTotalChargeUsd < 0.0017) throw new Error('Run cap must be at least $0.0017.');\nconst maxRows = c.queries.length * c.maxItemsPerQuery;\nif (c.resolveArticleUrls && maxRows > 200) throw new Error('Direct links support at most 200 requested records per run.');\nconst estimatedMaximum = 0.0015 + maxRows * 0.0002;\nif (c.maxTotalChargeUsd + 1e-10 < estimatedMaximum) throw new Error('Cap is below the configured maximum ($' + estimatedMaximum.toFixed(4) + '). Reduce records or increase the cap.');\nreturn [{json:c}];"
      }
    },
    {
      "id": "news-4",
      "name": "Start Actor",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        720,
        200
      ],
      "parameters": {
        "method": "POST",
        "url": "https://api.apify.com/v2/actors/monkey.d.scraping~google-news-scraper-lite/runs",
        "authentication": "genericCredentialType",
        "genericAuthType": "httpBearerAuth",
        "options": {
          "timeout": 75000,
          "response": {
            "response": {
              "responseFormat": "json"
            }
          }
        },
        "sendQuery": true,
        "queryParameters": {
          "parameters": [
            {
              "name": "waitForFinish",
              "value": "60"
            },
            {
              "name": "timeout",
              "value": "120"
            },
            {
              "name": "memory",
              "value": "128"
            },
            {
              "name": "build",
              "value": "latest"
            },
            {
              "name": "restartOnError",
              "value": "false"
            },
            {
              "name": "maxTotalChargeUsd",
              "value": "={{ $json.maxTotalChargeUsd }}"
            }
          ]
        },
        "sendBody": true,
        "specifyBody": "json",
        "jsonBody": "={{ JSON.stringify({queries:$json.queries, edition:$json.edition, period:$json.period, maxItemsPerQuery:$json.maxItemsPerQuery, resolveArticleUrls:$json.resolveArticleUrls}) }}"
      },
      "retryOnFail": false,
      "maxTries": 3,
      "waitBetweenTries": 1000,
      "notes": "Select the same Apify Bearer Auth credential on all four HTTP nodes. Never enable automatic retries on Start Actor: a repeated POST can start and bill another run.",
      "notesInFlow": false
    },
    {
      "id": "news-5",
      "name": "Wait for Run",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        960,
        200
      ],
      "parameters": {
        "method": "GET",
        "url": "=https://api.apify.com/v2/actor-runs/{{ $json.data.id }}",
        "authentication": "genericCredentialType",
        "genericAuthType": "httpBearerAuth",
        "options": {
          "timeout": 75000,
          "response": {
            "response": {
              "responseFormat": "json"
            }
          }
        },
        "sendQuery": true,
        "queryParameters": {
          "parameters": [
            {
              "name": "waitForFinish",
              "value": "60"
            }
          ]
        }
      },
      "retryOnFail": true,
      "maxTries": 3,
      "waitBetweenTries": 1000,
      "notes": "Select the same Apify Bearer Auth credential on all four HTTP nodes. Never enable automatic retries on Start Actor: a repeated POST can start and bill another run.",
      "notesInFlow": false
    },
    {
      "id": "news-6",
      "name": "Validate Run",
      "type": "n8n-nodes-base.code",
      "typeVersion": 2,
      "position": [
        1200,
        200
      ],
      "parameters": {
        "jsCode": "const r = $input.first().json.data;\nif (!r?.id) throw new Error('Missing Apify run ID.');\nif (r.status !== 'SUCCEEDED') throw new Error('Apify run ' + r.id + ' is ' + r.status + '. Inspect it in Console. If still running, resume with Wait for Run using this ID after it finishes; do not restart Start Actor to fetch the same results.');\nif (!r.defaultDatasetId || !r.defaultKeyValueStoreId) throw new Error('Run has no output storage IDs.');\nreturn [{json:r}];"
      }
    },
    {
      "id": "news-7",
      "name": "Get Run Summary",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        1440,
        200
      ],
      "parameters": {
        "method": "GET",
        "url": "=https://api.apify.com/v2/key-value-stores/{{ $json.defaultKeyValueStoreId }}/records/RUN_SUMMARY",
        "authentication": "genericCredentialType",
        "genericAuthType": "httpBearerAuth",
        "options": {
          "timeout": 75000,
          "response": {
            "response": {
              "responseFormat": "json"
            }
          }
        }
      },
      "retryOnFail": true,
      "maxTries": 3,
      "waitBetweenTries": 1000,
      "notes": "Select the same Apify Bearer Auth credential on all four HTTP nodes. Never enable automatic retries on Start Actor: a repeated POST can start and bill another run.",
      "notesInFlow": false
    },
    {
      "id": "news-8",
      "name": "Check Complete Output",
      "type": "n8n-nodes-base.code",
      "typeVersion": 2,
      "position": [
        1680,
        200
      ],
      "parameters": {
        "jsCode": "const s = $input.first().json;\nif (s.complete !== true || s.budgetLimited === true || s.queriesFailed > 0 || s.queriesSkipped > 0) throw new Error('Apify output is partial or unverified. Inspect RUN_SUMMARY before exporting. No sheet rows were written.');\nif (!Number.isInteger(s.savedRows) || s.savedRows < 0) throw new Error('Invalid savedRows in RUN_SUMMARY.');\nreturn [{json:{datasetId:$('Validate Run').first().json.defaultDatasetId, expectedRows:s.savedRows}}];"
      }
    },
    {
      "id": "news-9",
      "name": "Get Dataset Items",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        1920,
        200
      ],
      "parameters": {
        "method": "GET",
        "url": "=https://api.apify.com/v2/datasets/{{ $json.datasetId }}/items",
        "authentication": "genericCredentialType",
        "genericAuthType": "httpBearerAuth",
        "options": {
          "timeout": 75000,
          "response": {
            "response": {
              "responseFormat": "json"
            }
          }
        },
        "sendQuery": true,
        "queryParameters": {
          "parameters": [
            {
              "name": "clean",
              "value": "true"
            },
            {
              "name": "format",
              "value": "json"
            },
            {
              "name": "limit",
              "value": "2000"
            }
          ]
        }
      },
      "retryOnFail": true,
      "maxTries": 3,
      "waitBetweenTries": 1000,
      "notes": "Select the same Apify Bearer Auth credential on all four HTTP nodes. Never enable automatic retries on Start Actor: a repeated POST can start and bill another run.",
      "notesInFlow": false
    },
    {
      "id": "news-10",
      "name": "Prepare Sheet Rows",
      "type": "n8n-nodes-base.code",
      "typeVersion": 2,
      "position": [
        2160,
        200
      ],
      "parameters": {
        "jsCode": "const input = $input.all();\nconst rows = input.flatMap(i => Array.isArray(i.json) ? i.json : [i.json]);\nconst expected = $('Check Complete Output').first().json.expectedRows;\nif (rows.length !== expected) throw new Error('Dataset row count mismatch; no rows exported.');\nconst seen = new Set();\nreturn rows.map(r => {\n  if (typeof r.id !== 'string' || !r.id || seen.has(r.id)) throw new Error('Missing or duplicate article ID.');\n  seen.add(r.id);\n  const keys = ['id','title','publisher','publishedAt','articleUrl','googleNewsUrl','edition','collectedAt','articleUrlStatus'];\n  const out = Object.fromEntries(keys.map(k => [k, r[k] == null ? '' : String(r[k])]));\n  out.matchedQueries = Array.isArray(r.matchedQueries) ? r.matchedQueries.join(' | ') : String(r.query ?? '');\n  return {json:out};\n});"
      }
    },
    {
      "id": "news-11",
      "name": "Save News to Google Sheets",
      "type": "n8n-nodes-base.googleSheets",
      "typeVersion": 4.6,
      "position": [
        2400,
        200
      ],
      "parameters": {
        "resource": "sheet",
        "operation": "appendOrUpdate",
        "documentId": {
          "__rl": true,
          "value": "={{ $('Configuration').first().json.spreadsheetId }}",
          "mode": "id"
        },
        "sheetName": {
          "__rl": true,
          "value": "={{ $('Configuration').first().json.sheetName }}",
          "mode": "name"
        },
        "columns": {
          "mappingMode": "autoMapInputData",
          "value": {},
          "matchingColumns": [
            "id"
          ],
          "schema": [
            {
              "id": "id",
              "displayName": "id",
              "required": false,
              "defaultMatch": true,
              "display": true,
              "type": "string",
              "canBeUsedToMatch": true
            },
            {
              "id": "title",
              "displayName": "title",
              "required": false,
              "defaultMatch": false,
              "display": true,
              "type": "string",
              "canBeUsedToMatch": true
            },
            {
              "id": "publisher",
              "displayName": "publisher",
              "required": false,
              "defaultMatch": false,
              "display": true,
              "type": "string",
              "canBeUsedToMatch": true
            },
            {
              "id": "publishedAt",
              "displayName": "publishedAt",
              "required": false,
              "defaultMatch": false,
              "display": true,
              "type": "string",
              "canBeUsedToMatch": true
            },
            {
              "id": "articleUrl",
              "displayName": "articleUrl",
              "required": false,
              "defaultMatch": false,
              "display": true,
              "type": "string",
              "canBeUsedToMatch": true
            },
            {
              "id": "googleNewsUrl",
              "displayName": "googleNewsUrl",
              "required": false,
              "defaultMatch": false,
              "display": true,
              "type": "string",
              "canBeUsedToMatch": true
            },
            {
              "id": "matchedQueries",
              "displayName": "matchedQueries",
              "required": false,
              "defaultMatch": false,
              "display": true,
              "type": "string",
              "canBeUsedToMatch": true
            },
            {
              "id": "edition",
              "displayName": "edition",
              "required": false,
              "defaultMatch": false,
              "display": true,
              "type": "string",
              "canBeUsedToMatch": true
            },
            {
              "id": "collectedAt",
              "displayName": "collectedAt",
              "required": false,
              "defaultMatch": false,
              "display": true,
              "type": "string",
              "canBeUsedToMatch": true
            },
            {
              "id": "articleUrlStatus",
              "displayName": "articleUrlStatus",
              "required": false,
              "defaultMatch": false,
              "display": true,
              "type": "string",
              "canBeUsedToMatch": true
            }
          ],
          "attemptToConvertTypes": false,
          "convertFieldsToString": false
        },
        "options": {
          "cellFormat": "RAW",
          "handlingExtraData": "ignoreIt"
        }
      },
      "notes": "Select your Google Sheets OAuth2 credential. Create the News tab with the exact headers from the tutorial. Append or Update matches id; RAW stores headlines as text.",
      "notesInFlow": true
    }
  ],
  "connections": {
    "Manual Trigger": {
      "main": [
        [
          {
            "node": "Configuration",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Configuration": {
      "main": [
        [
          {
            "node": "Validate Configuration",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Validate Configuration": {
      "main": [
        [
          {
            "node": "Start Actor",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Start Actor": {
      "main": [
        [
          {
            "node": "Wait for Run",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Wait for Run": {
      "main": [
        [
          {
            "node": "Validate Run",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Validate Run": {
      "main": [
        [
          {
            "node": "Get Run Summary",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Get Run Summary": {
      "main": [
        [
          {
            "node": "Check Complete Output",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Check Complete Output": {
      "main": [
        [
          {
            "node": "Get Dataset Items",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Get Dataset Items": {
      "main": [
        [
          {
            "node": "Prepare Sheet Rows",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Prepare Sheet Rows": {
      "main": [
        [
          {
            "node": "Save News to Google Sheets",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  },
  "active": false,
  "settings": {
    "executionOrder": "v1"
  },
  "pinData": {},
  "tags": [],
  "id": "googleNewsSheetsTemplate"
}

More Actors by Monkey D. Scraping

Combine news research with these complementary tools from the same developer. Each Actor runs separately with its own inputs and pricing.

Recommended ActorWhen to use it
Google Trends Scraper — Keyword History APICompare news coverage with keyword search-interest history by country and period.
Telegram New Posts Monitor & Channel DiscoveryFollow new posts from public Telegram channels using saved task checkpoints, alongside your news-monitoring workflow.

If a run stops during saving

Records saved before the stop stay in the dataset and are the only ones charged. Check the dataset and deduplicate by id before starting a new run.

Why do query counts differ from the number of news rows?

An article found by several searches is saved once. query is the first associated search; matchedQueries lists all of them. Use every value in matchedQueries when grouping articles by search, so per-search counts can add up to more than the number of unique articles.

The default News headlines view puts all matching searches and the Google News link next to the headline. Open Publisher links and metadata for direct links, descriptions, images and their status, or All article fields for the complete record.

If resolveArticleUrls is false, articleUrl is null and articleUrlStatus is not_requested. Open googleNewsUrl to read the article. publisherHomepage is the publication homepage, not the article. Selecting an output view does not change what is collected or charged.

Actor input Schema

queries (type: array):

One company, person or topic per line, up to 20. For an exact name, include quotation marks, e.g. "Microsoft". Matching articles are deduplicated across searches.

edition (type: string):

Select a Google News country edition and its language together.

period (type: string):

Past 24 hours, 7 days or 30 days, or Custom dates for a historical search. Filling in a date below selects Custom dates automatically.

dateFrom (type: string):

For historical searches, from 1970 onward. Leave empty for the rolling periods above. Long ranges, up to ten years, are searched in consecutive date windows automatically.

dateTo (type: string):

Inclusive final date. Leave empty to search up to today; future dates are set to today.

maxItemsPerQuery (type: integer):

Start with 10 (up to $0.0035 including startup for one keyword). Up to 300 per keyword; above 100, more date windows are searched automatically. Results depend on availability.

expandCoverage (type: boolean):

Splits the period into smaller date windows to find more articles per keyword and removes duplicates. Recommended for custom dates longer than a few months. Turned on automatically above 100 articles per keyword; takes longer.

resolveArticleUrls (type: boolean):

Adds the direct publisher URL to each collected article; takes longer. Unavailable links stay empty with an explicit status.

enrichArticles (type: boolean):

Adds the publisher description and image of each article when available, and turns on direct links automatically. Does not include full article text.

includeTitleTerms (type: array):

Optional literal words or phrases, case-insensitive. A headline must contain at least one; leave empty to keep all. Example: Mario Calabresi. Applied before saving and charging.

excludeTitleTerms (type: array):

Optional literal words or phrases, case-insensitive. Matching headlines are excluded before saving and charging. Filtering counts appear in the summary.

processingBudgetSeconds (type: integer):

Default 15 minutes. The default run timeout is 60 minutes, so budgets up to 3,570 seconds need no other change; for 3,600, raise the run timeout slightly. The maximum cost per run is a separate spending limit.

strictMode (type: boolean):

Off: unavailable optional publisher links or metadata produce warnings while collected headlines remain usable. On: incomplete requested output fails the run. Collection and storage errors still fail regardless.

Actor input object example

{
  "queries": [
    "Microsoft"
  ],
  "edition": "en-US",
  "period": "week",
  "maxItemsPerQuery": 10,
  "expandCoverage": false,
  "resolveArticleUrls": false,
  "enrichArticles": false,
  "processingBudgetSeconds": 900,
  "strictMode": false
}

Actor output Schema

overview (type: string):

Unique headlines, all matching searches and Google News links. Optional fields are available in the dedicated dataset view.

news (type: string):

Headlines, publishers, dates, optional direct article links and optional publisher descriptions/images with explicit status.

summary (type: string):

Check completeness, saved and charged records, customer budget limits and direct-link status.

queries (type: string):

Per-query article counts, reached maximums, date windows searched and suggested next steps.

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

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": [
        "Microsoft"
    ],
    "edition": "en-US",
    "period": "week",
    "maxItemsPerQuery": 10,
    "expandCoverage": false,
    "resolveArticleUrls": false,
    "enrichArticles": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("monkey.d.scraping/google-news-scraper-lite").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

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": ["Microsoft"],
    "edition": "en-US",
    "period": "week",
    "maxItemsPerQuery": 10,
    "expandCoverage": False,
    "resolveArticleUrls": False,
    "enrichArticles": False,
}

# Run the Actor and wait for it to finish
run = client.actor("monkey.d.scraping/google-news-scraper-lite").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

echo '{
  "queries": [
    "Microsoft"
  ],
  "edition": "en-US",
  "period": "week",
  "maxItemsPerQuery": 10,
  "expandCoverage": false,
  "resolveArticleUrls": false,
  "enrichArticles": false
}' |
apify call monkey.d.scraping/google-news-scraper-lite --silent --output-dataset

MCP server setup

{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,monkey.d.scraping/google-news-scraper-lite"
        }
    }
}

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/a5xfMzCmkvgPiMrH3/builds/FyWJpNZVwPwVZCer0/openapi.json