Response Fields

This page describes the structure and meaning of fields returned by the Google News API. The response contains metadata about the request and a list of hotel results extracted from Google Hotels.

Field Summary

The table below provides a quick overview of the main fields returned by the Google News API response.

Field
Type
Description

url

string

Final Google News search URL used to retrieve the results.

general

object

Metadata about the search environment and request configuration.

input

object

Information about the original request processed by the API.

newsResults

array

List of news article objects extracted from Google News.

pagination

object

Navigation data for paginating through result pages.

pagesProcessed

integer

Number of result pages processed in this request.


News Result Object Fields Summary

Each element inside the newsResults array contains the following fields:

Field
Type
Description

title

string

Headline of the news article.

source

string

Name of the publication or website that published the article.

timeSince

string

Human-readable string indicating when the article was published.

link

string

Direct URL to the full news article.

image

string

Thumbnail image for the article returned as a base64-encoded data URI.

description

string

Short excerpt or summary of the article content.

rank

integer

Position of the article in the current page of results.


Top-Level Fields

url

The final Google News URL used to retrieve the results.

This URL reflects the fully constructed search query including language, country, and encoded Google parameters.

Example


general

Metadata describing the request environment and search configuration.

Fields

Field
Description

searchEngine

Search engine used for the request.

resultsCount

Approximate total number of results Google reports for the query.

searchTime

Time in seconds Google took to process the search.

language

Language used in the request.

device

Device type used for the request.

searchType

Type of search performed.

pageTitle

Title of the Google News results page.

timestamp

Timestamp when the request was processed.

render

Indicates whether rendering was enabled.

Example


input

Information about the original request processed by the API.

Fields

Field
Description

originalUrl

Google search URL generated from the request parameters.

jobId

Unique identifier assigned to the scraping job.

Example


pagination

Navigation data for moving between pages of results.

Fields

Field
Description

nextPageLink

Full URL for the next page of results.

prevPageLink

Full URL for the previous page of results. Only present when not on page 1.

nextPageStart

The start offset value for the next page.

prevPageStart

The start offset value for the previous page.

currentPage

The current page number.

nextPage

The next page number.

prevPage

The previous page number.

otherPages

Map of available page numbers to their corresponding URLs.

Example


newsResults Array

The newsResults field contains a list of news article objects extracted from Google News. Each object represents a single article listing.

Example


News Result Object Fields

title

Headline of the news article.

source

Name of the publication or website that published the article.

timeSince

Human-readable string indicating how long ago the article was published.

Direct URL to the full news article.

image

Thumbnail image for the article, returned as a base64-encoded data URI.

description

Short excerpt or summary of the article content.

rank

Position of the article in the current page of results.


Example News Result Object

Last updated