JustSERPDocs
Google

Google News Light

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`).

GET
/v1/google/news/light

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). The same page and articles as /v1/google/news cut to Light's fields: no favicon, is_live, total_results or other_pages. Desktop only; device, lr, cr, time_period_min/max and link are not Light's and are ignored; a wrong value is a 400. A search with no results is search_information alone.

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

cancel_token?string

A 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.

Length1 <= length <= 128
q*string
Length1 <= length <= 2000
location?string

No effect seen on News.

uule?string
hl?string
Default"en"
gl?string
Default"us"
nfpr?string
Value in"0""1"
filter?string
Value in"0""1"
page?integer
Range1 <= value <= 100
Default1
time_period?string
Value in"last_hour""last_day""last_week""last_month""last_year"
sort_by?"most_recent"
Value in"most_recent"

Response Body

One page of articles, as the document. When the page could not be parsed, the usual envelope.

application/json
  1. response

The Google News Light document. No favicon, is_live, total_results, other_pages. A search with no results is search_information alone.

search_metadata*
search_parameters*

The parameters the search ran with, defaults filled in; engine is the engine's name.

search_information?
organic_results?array<>
top_stories?array<>
pagination?
Example Request
curl -X GET 'https://api.justserp.com/v1/google/news/light?q=tesla&time_period=last_day&sort_by=most_recent'
Example Response
{  "search_metadata": {    "id": "string",    "status": "Success",    "created_at": "string",    "request_url": "string",    "html_url": "string"  },  "search_parameters": {},  "search_information": {    "query_displayed": "string",    "showing_results_for": "string",    "page": 0  },  "organic_results": [    {      "position": 0,      "title": "string",      "link": "string",      "source": "string",      "date": "string",      "snippet": "string",      "thumbnail": "string"    }  ],  "top_stories": [    {      "position": 0,      "title": "string",      "link": "string",      "source": "string",      "date": "string"    }  ],  "pagination": {    "current": 0,    "previous": "string",    "next": "string"  }}

Google News GET

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).

Google place details GET

One Google place by its id, opened from the id (never through a search): name, categories, address, phone, website, status, hours, attributes, rating.