# Response Fields

### 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**

```json
"url": "https://www.google.com/search?gl=US&hl=en&q=ai&tbm=nws&uule=w+CAIQICINVW5pdGVkIFN0YXRlcw"
```

***

#### 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**

```json
"general": {
  "searchEngine": "google_news",
  "resultsCount": 13600000,
  "searchTime": 0.76,
  "language": "en",
  "device": "desktop",
  "searchType": "text",
  "pageTitle": "ai - Google Search",
  "timestamp": "2026-04-19T14:13:12.868546494Z",
  "render": false
}
```

***

#### 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**

```json
"input": {
  "originalUrl": "https://www.google.com/search?gl=US&hl=en&q=ai&tbm=nws",
  "jobId": "36344139-9f78-44f3-8d0c-f0d9f7e2d8ea"
}
```

***

#### 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**

```json
"pagination": {
  "nextPageLink": "https://www.google.com/search?q=ai&tbm=nws&start=10",
  "nextPageStart": 10,
  "currentPage": 1,
  "nextPage": 2,
  "otherPages": {
    "2": "https://www.google.com/search?q=ai&tbm=nws&start=10",
    "3": "https://www.google.com/search?q=ai&tbm=nws&start=20"
  }
}
```

***

### newsResults Array

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

**Example**

```json
"newsResults": [
  { ...article object... }
]
```

***

### News Result Object Fields

#### title

Headline of the news article.

```json
"title": "Should you really trust health advice from an AI chatbot?"
```

#### source

Name of the publication or website that published the article.

```json
"source": "BBC"
```

#### timeSince

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

```json
"timeSince": "15 hours ago"
```

#### link

Direct URL to the full news article.

```json
"link": "https://www.bbc.com/news/articles/clyepyy82kxo"
```

#### image

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

```json
"image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/..."
```

#### description

Short excerpt or summary of the article content.

```json
"description": "So should we trust the likes of ChatGPT, Gemini and Grok? Is using them any different to an old-fashioned internet search?"
```

#### rank

Position of the article in the current page of results.

```json
"rank": 1
```

***

### Example News Result Object

```json
{
  "title": "Should you really trust health advice from an AI chatbot?",
  "source": "BBC",
  "timeSince": "15 hours ago",
  "link": "https://www.bbc.com/news/articles/clyepyy82kxo",
  "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/...",
  "description": "So should we trust the likes of ChatGPT, Gemini and Grok? Is using them any different to an old-fashioned internet search?",
  "rank": 1
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.netnut.io/netnut-documentation/netnut-scraper-apis/serp-api/google-scraper/google-news/response-fields.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.