Features
A detailed overview of the Google News API capabilities
Search Query
The q parameter is the main search input for Google News. It accepts any keyword, phrase, or combination of terms and supports standard Google News search operators such as site:, intitle:, and quoted phrases for exact matching.
Parameter
q: string
Example
https://serp-api.netnut.io/search?engine=google_news&q=artificial+intelligenceUse Cases
Keyword-based news monitoring
Brand and product mention tracking
Topic research and content discovery
Language
Defines the language of the Google News results and search interface.
Parameter
hl: string
Example
Use Cases
Retrieve results in a specific language
Localized news monitoring workflows
Multi-language content pipelines
Geographic Location
Defines the country context for the Google News search. This influences which regional editions of news sources are surfaced in the results.
Parameter
gl: string
Example
Use Cases
Country-specific news retrieval
Regional market monitoring
International media comparison
Language and Location Combined
You can combine hl and gl to precisely target a language and country together. These two parameters work independently and can be mixed freely, for example retrieving English-language results within a German geographic context.
Parameters
hl: string
gl: string
Example
Use Cases
Localized news intelligence
Competitive monitoring across markets
International editorial research
Pagination
Controls which page of results to retrieve. Google News returns approximately 10 results per page. Use multiples of 10 to paginate through result sets.
Parameter
start: integer
Example
Use Cases
Retrieve results beyond the first page
Build news archives across many pages
Large-scale article collection workflows
Raw HTML Output
Controls whether raw HTML is returned alongside or instead of the structured JSON response.
Setting rawHtml=1 appends the full HTML of the Google News results page under the html key in the response. Setting rawHtml=2 returns only the raw HTML with no structured data.
Parameter
rawHtml: integer
Example (structured JSON plus raw HTML)
Example (raw HTML only)
Use Cases
Custom extraction logic from raw markup
Archiving the full rendered results page
Debugging structured field discrepancies
Combined Example
You can combine multiple parameters to create a more precise Google News search.
Example
This request will:
Search Google News for
artificial intelligenceUse English results for the US market
Retrieve the second page of results
Return both structured JSON and raw HTML
Last updated