# Features

### Search Query

The `q` parameter is the main search input for Google News. It accepts any keyword, phrase, or combination of terms and supports standard Google News search operators such as `site:`, `intitle:`, and quoted phrases for exact matching.

**Parameter**

`q: string`

**Example**

```http
https://serp-api.netnut.io/search?engine=google_news&q=artificial+intelligence
```

**Use Cases**

* Keyword-based news monitoring
* Brand and product mention tracking
* Topic research and content discovery

***

### Language

Defines the language of the Google News results and search interface.

**Parameter**

`hl: string`

**Example**

```http
https://serp-api.netnut.io/search?engine=google_news&q=ai&hl=en
```

**Use Cases**

* Retrieve results in a specific language
* Localized news monitoring workflows
* Multi-language content pipelines

***

### Geographic Location

Defines the country context for the Google News search. This influences which regional editions of news sources are surfaced in the results.

**Parameter**

`gl: string`

**Example**

```http
https://serp-api.netnut.io/search?engine=google_news&q=economy&gl=us
```

**Use Cases**

* Country-specific news retrieval
* Regional market monitoring
* International media comparison

***

### Language and Location Combined

You can combine `hl` and `gl` to precisely target a language and country together. These two parameters work independently and can be mixed freely, for example retrieving English-language results within a German geographic context.

**Parameters**

`hl: string`

`gl: string`

**Example**

```
https://serp-api.netnut.io/search?engine=google_news&q=tech&hl=en&gl=gb
```

**Use Cases**

* Localized news intelligence
* Competitive monitoring across markets
* International editorial research

***

### Pagination

Controls which page of results to retrieve. Google News returns approximately 10 results per page. Use multiples of 10 to paginate through result sets.

**Parameter**

`start: integer`

**Example**

```
https://serp-api.netnut.io/search?engine=google_news&q=ai&start=10
```

**Use Cases**

* Retrieve results beyond the first page
* Build news archives across many pages
* Large-scale article collection workflows

***

### Raw HTML Output

Controls whether raw HTML is returned alongside or instead of the structured JSON response.

Setting `rawHtml=1` appends the full HTML of the Google News results page under the `html` key in the response. Setting `rawHtml=2` returns only the raw HTML with no structured data.

**Parameter**

`rawHtml: integer`

**Example (structured JSON plus raw HTML)**

```
https://serp-api.netnut.io/search?engine=google_news&q=ai&rawHtml=1
```

**Example (raw HTML only)**

```
https://serp-api.netnut.io/search?engine=google_news&q=ai&rawHtml=2
```

**Use Cases**

* Custom extraction logic from raw markup
* Archiving the full rendered results page
* Debugging structured field discrepancies

***

### Combined Example

You can combine multiple parameters to create a more precise Google News search.

**Example**

```
https://serp-api.netnut.io/search?engine=google_news&q=artificial+intelligence&hl=en&gl=us&start=10&rawHtml=1
```

This request will:

* Search Google News for `artificial intelligence`
* Use English results for the US market
* Retrieve the second page of results
* Return both structured JSON and raw HTML


---

# 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/features.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.