Skip to content

Google News Headline Extraction by Country

Use this guide to collect current Google News headlines as structured records, narrow the edition by country, and check the fields you receive before storing or analysing them.

OUTPUT FORMATSHTMLJSONMarkdown

What you get from each headline

A headline record is most useful when you can sort it by topic, outlet and time without parsing page markup. This workflow returns one object per story with the fields listed in the field map below. Use it to watch a developing story, see which outlets are carrying it, and compare how the same event is framed in different countries.

Inputs: country and optional topic

Set country_code to the edition you want, for example US, UK or IN. Add the optional topic identifier when you need a narrower feed rather than the main country edition. The worked example in protected module code0002 shows a successful response containing a count, a news_extracts array, and an info field reporting 200 SUCCESS; its first entries illustrate how title, source, time, author and link appear together for several outlets. Treat that example as a dated illustration of shape, not as current headlines.

Field and control map

title: headline text. source: publishing outlet. time: publication timestamp. author: byline. link: direct link to the full article. count: number of records returned. news_extracts: the array of headline objects. info: status summary for the call. Check that count matches the length of news_extracts and that time values parse as timestamps before loading records downstream.

Choosing extraction, interaction or screenshots

The documented feature set includes extraction rules for requesting only the fields you need instead of handling raw HTML, JavaScript scenarios that can click, scroll, wait for dynamic content or run custom code when a page needs interaction before data appears, screenshot capture for a visual record rather than extracted fields, and a separate search-results API for general search results rather than the news feed itself. Confirm which of these are enabled on your account before relying on them: {{OWNER_FEATURE_SET}}.

Pre-flight checklist

Before a first run, confirm these points: 1) Your country_code uses the expected format. 2) The topic value, if used, is a valid Google News topic identifier. 3) Your API key is present and correct, since an invalid-key response is handled explicitly in protected module code0001. 4) The response contains a non-empty news_extracts array; an empty array should be treated as a failed retrieval rather than a valid empty feed. 5) Timestamps, links and bylines are present on the records you plan to store.

Pricing and plan selection

Plans differ in monthly API credits, concurrent requests, geotargeting, screenshots and extraction rules, dedicated scraping APIs, priority email support, dedicated account management and team management, with prices exclusive of VAT. Do not publish plan figures until the owner confirms them: {{OWNER_PRICING_AND_PLANS}}. The same template should confirm any starter credit allowance, cancellation wording and support commitments before they appear on the page. Feature availability referenced elsewhere on this page is governed by {{OWNER_FEATURE_SET}}.

Headline fields at a glance
FieldUse it to
titleIdentify the story
sourceGroup coverage by outlet
timeOrder stories chronologically
authorAttribute reporting
linkOpen the full article

Fields are those returned in the documented headline output.

Frequently asked questions

What data can I extract from Google News?

Each record contains the article title, publishing outlet, timestamp, byline, and a link to the full story, returned as structured JSON for storage or analysis.

Can I target news from specific countries?

Yes. Supply a country code such as US, UK, DE, FR, JP or IN to retrieve the edition for that region, which supports comparing coverage and priorities between markets.

Is the Google News API powered by AI?

The documented AI-assisted extraction option lets you state the data you want in plain English instead of building selectors, adapts when page layout changes and returns clean JSON alongside anti-bot handling. Confirm availability on your account before relying on it: {{OWNER_FEATURE_SET}}.

How often is the data updated?

Headlines are retrieved directly from Google News as they appear there, so freshness follows Google News itself, which updates continuously as stories break.

How do I get started with the Google News API?

Register for an API key, install the SDK, set a country code, and run a documented example. The owner-confirmed starter allowance and registration terms are recorded in the owner template below.

Is there a limit to how many headlines I can extract?

A single call typically returns hundreds of headlines. How much you can collect overall depends on the plan you choose, from occasional monitoring to enterprise-scale analysis.