Google News API
Google News API
Our Google News API allows you to scrape results from the Google News search page.
Api Details
Endpoint
GET https://serpapi.abcproxy.com/search
Description Retrieve comprehensive user profile including
basic info
,account status
and optionalpermission sets
.
Request
HTTP Request
API Parameters
Search Query
q
string
Yes
Parameter defines the query you want to search. You can use anything that you would use in a regular Google News search
coffee
Localization
gl
string
No
Amgola-ao
hl
string
No
Akan-ak
Advanced Parameters
topic_token
string
No
Parameter defines the Google News topic token. It is used for accessing the news results for a specific topic .
Parameter can not be used together with q
, story_token
, and publication_token
parameters
World
publication_token
string
No
Parameter defines the Google News publication token. It is used for accessing the news results from a specific publishe.
Parameter can’t be used together with q
, story_token
, and topic_token
parameters.
CNN
BBC
section_token
string
No
Parameter defines the Google News section token. It is used for accessing the sub-section of a specific topic.
The token can be found in our JSON response or the URL of the Google News page (in the URL, it is a string of characters preceded by /sections/
)
Parameter can only be used in combination with topic_token or publication_token parameters.
Business -> Economy
story_token
string
No
Parameter defines the Google News story token. It is used for accessing the news results with full coverage of a specific story.
The token can be found in our JSON response or the URL of the Google News page (in the URL, it is a string of characters preceded by /stories/
)
Parameter can’t be used together with q
, topic_token
, and publication_token
parameters.
-
so
string
No
Parameter defines the sorting method. Results can be sorted by relevance or by date. By default, the results are sorted by relevance. List of supported values are:0
- Relevance;1
- Date
Parameter can only be used in combination with story_token
parameter.
-
Serpapi Parameters
engine
string
Yes
Set parameter to google_news
to use the Google News API engine.
google_news
no_cache
boolean
No
Parameter will force SerpApi to fetch the Google News results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false
(default) to allow results from the cache, or true
to disallow results from the cache. no_cache and async parameters should not be used together.
true
orfalse
api_key
string
Yes
Parameter defines the SerpApi private key to use.
YOUR_API_KEY
Response
Success 200
Response Body
Response Fields
search_metadata
object
Contains timing
and status information
search_parameters
object
Contains query parameters
and search context
title
string
page title
top_stories_link
object
Focus news link
news_results
object[]
News search
results
menu_links
object[]
Menu link
sub_menu_links
object[]
Submenu link
related_topics
object[]
related subject
related_publications
object[]
Related publications
stories
object
story
highlight
string
Highligh
t the results section
story_token
string
Story token
Error Responses
Common Errors
200
400
API Key can not be empty
200
401
Param error
200
402
API Key error
200
403
Insufficient Balance
200
404
Deduction failed
200
405
Failed to record usage count
200
406
Unsupported engine
200
407
Network error
200
408
File not found
200
409
Limit param error
200
410
Build url error
200
411
Failed to QueryRecentRecord
200
412
Failed to find json
200
413
Get html error
200
414
HTML is empty
200
429
Too many request
Error Example
Last updated