JustSERPDocs
Google

Google News Portal

news.google.com itself: the front page, a search (`q`), a topic (`topic_token`, with `section_token`) or a story's full coverage (`story_token`), answered as the document: `search_metadata`, `search_parameters`, `search_information`, `organic_results` and `menu_topics`.

GET
/v1/google/news/portal

news.google.com itself: the front page, a search (q), a topic (topic_token, with section_token) or a story's full coverage (story_token), answered as the document: search_metadata, search_parameters, search_information, organic_results and menu_topics. Not answered: related_topics, related_publications, the articles' authors; publication_token is a 400 (a publisher's page holds no articles for a plain client); a story answers by its lead article. No snapshot.

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

A search.

ceid?string

Country and language, US:en (becomes hl, gl, ceid).

Match^[A-Za-z]{2}:[A-Za-z]{2,}
Default"US:en"
topic_token?string

A topic (from menu_topics).

section_token?string

A section of the topic; needs topic_token.

story_token?string

A story's full coverage.

sort_by?string

With story_token; date is newest first.

Default"relevance"
Value in"relevance""date"

Response Body

The page, as the document. When the page could not be parsed, the usual envelope.

application/json
  1. response

The News Portal document.

search_metadata?
search_parameters?

The request as sent.

search_information?
organic_results?array<>
menu_topics?array<>
[key: string]?any
Example Request
curl -X GET 'https://api.justserp.com/v1/google/news/portal?ceid=US%3Aen'
Example Response
{  "search_metadata": {    "id": "string",    "status": "string",    "created_at": "string",    "request_url": "string"  },  "search_parameters": {},  "search_information": {},  "organic_results": [    {      "position": 0,      "story_token": "string",      "title": "string",      "link": "string",      "thumbnail": "string",      "iso_date": "string",      "source": {        "name": "string",        "favicon": "string"      }    }  ],  "menu_topics": [    {      "title": "string",      "topic_token": "string"    }  ]}

Google Finance GET

Google Finance: a stock, index, fund, currency pair or coin, answered as the document: `search_metadata`, `search_parameters`, `search_information`, `summary`, `graph`, `knowledge_graph` (`stats`, and `about` for stocks only), `news`, `compare_to`, `markets` and `lists`.

Google Trends Autocomplete GET

Google Trends' suggestions for the start of a query (Google answers from about 3 characters), answered as the document: `search_metadata`, `search_parameters`, `search_information` and `suggestions` (`id` Google's topic id, `title`, `type`, `link`; no thumbnail, the box does not send one).