Google News
The articles in Google's News tab for a search: title, publisher, snippet, age, the time of the article (`iso_date`, from the page's own data), thumbnail and the story group each sits in (the `news_results` field names).
The articles in Google's News tab for a search: title, publisher, snippet, age, the time of the
article (iso_date, from the page's own data), thumbnail and the story group each sits in
(the news_results field names). A page is 10 articles, or more when Google puts story
groups ("Top news", "News about …") above them; pagination links the pages and start
asks for one. Time filter: when; order: sort_by.
In the document form. $1 request $2 q and no query is the document-form Google News call
(q, device desktop, location/uule, hl, gl, lr, cr, nfpr, filter, page,
time_period, time_period_min/max, sort_by: most_recent, link), answered as the document:
search_metadata, search_parameters, search_information (with total_results),
organic_results, top_stories (the story groups above the list) and pagination.
link: resolved expands the articles' Google redirects. location/uule had no effect on
News in a test. Not returned: author, author_link, is_video, detected_location,
did_you_mean; iso_date, section, news_id, story_id are ours and are left out.
X-API-Key<token>Your API key.
cancel_token?stringA name you make up for this request (a UUID is fine), so you can later GET /v1/cancel
with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.
1 <= length <= 128query?string1 <= length <= 2000location?||stringwhen?string"hour""day""week""month""year"sort_by?|start?integerThe page offset: 0, 10, 20, …
0 <= value <= 9900q?string1 <= length <= 2000device?"desktop"mobile and tablet are a 400.
"desktop""desktop"uule?stringhl?string"en"gl?string"us"lr?stringLanguages, lang_xx, several joined by |.
cr?stringCountries, countryXX, several joined by |.
nfpr?string"0""1"filter?string"0""1"page?integer1 <= value <= 1001time_period?string"last_hour""last_day""last_week""last_month""last_year"time_period_min?stringMM/DD/YYYY; with time_period_max, not with time_period.
time_period_max?stringMM/DD/YYYY.
link?stringresolved replaces the articles' Google redirects with the sites' own addresses.
"raw""raw""resolved"One page of articles. news_results is [] with a news_results_state of no_results when Google has none; with q, the document.
application/json- response
The first three keys of every parsed 200 (the answer is the document itself, no success/data
envelope): what the search was (search_metadata), what it asked (search_parameters), the
parser's own search_information ({} when it has none). The engine's blocks follow, at the same
level. An engine whose answer is a list puts it under results.
search_metadata*search_parameters*The request's own fields as sent, engine first, without cancel_token.
search_information*The parser's own, e.g. yelp_search's; otherwise {}.
news_results*array<>pagination?Absent when the page has no navigation, and when there are no results.
curl -X GET 'https://api.justserp.com/v1/google/news?query=openai&location%5Bcountry%5D=us&location%5Blanguage%5D=en&when=week&sort_by=date&start=0'{ "search_metadata": { "id": "string", "status": "Success", "created_at": "string", "request_url": "string", "html_url": "string" }, "search_parameters": {}, "search_information": { "query_displayed": "string", "news_results_state": "results" }, "news_results": [ { "position": 0, "title": "string", "link": "string", "source": { "name": "string", "icon": "string" }, "snippet": "string", "date": "string", "iso_date": "2019-08-24T14:15:22Z", "thumbnail": "string", "live": true, "section": "string", "news_id": "string", "story_id": "string" } ], "pagination": { "current": 0, "next": "string", "other_pages": { "property1": "string", "property2": "string" } }}Google Jobs GET
The job listings Google shows in its Jobs tab for a search and a place: title, company, place, pay, schedule, benefit tags, "job highlights", the full description and every apply link (the `google_jobs` field names).
Google News Light GET
The articles in Google's News tab under the Google News Light parameters (`q`, `location`/`uule`, `hl`, `gl`, `nfpr`, `filter`, `page`, `time_period`, `sort_by`), answered as the document: `search_metadata`, `search_parameters`, `search_information` (`query_displayed`, `showing_results_for`, `page`), `organic_results` (`position`, `title`, `link`, `source`, `date`, `snippet`, `thumbnail`), `top_stories` (`position`, `title`, `link`, `source`, `date`) and `pagination` (`current`, `previous`, `next`).