# Google News (/docs/google-apis/google-news-api)





The Google News API endpoint provides fast and reliable access to real-time Google News search results.

<Callout type="warn">
  Requires authentication → provide your API key as a Bearer token in the
  Authorization header.
</Callout>

`POST` `https://api.serphouse.com/google-news`

<Callout type="info" title="Response types">
  These are the response types we support. Append a suffix to the endpoint to
  choose the response format.
</Callout>

| Format         | Endpoint                                     |
| -------------- | -------------------------------------------- |
| JSON (default) | `https://api.serphouse.com/google-news`      |
| Markdown       | `https://api.serphouse.com/google-news/md`   |
| HTML           | `https://api.serphouse.com/google-news/html` |

## Headers [#headers]

| Name                                                           | Type   | Description             |
| -------------------------------------------------------------- | ------ | ----------------------- |
| Authorization <span style="{color: &#x22;red&#x22;}">\*</span> | String | Bearer `<YOUR_API_KEY>` |
| Content-Type <span style="{color: &#x22;red&#x22;}">\*</span>  | String | application/json        |

## Request Body [#request-body]

| Name                                                     | Type              | Description                                                                                                                                                                                                                                                                                                                |
| -------------------------------------------------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| q <span style="{color: &#x22;red&#x22;}">\*</span>       | string            | Search phrase that you want to search                                                                                                                                                                                                                                                                                      |
| domain <span style="{color: &#x22;red&#x22;}">\*</span>  | string            | Choose google domain.<br /><br />You can retrieve the list of supported Google domains by making a separate request to the [Domains List](/extra-apis/domains-list)                                                                                                                                                        |
| device <span style="{color: &#x22;red&#x22;}">\*</span>  | string            | `desktop` To extract desktop result `mobile` To extract mobile result                                                                                                                                                                                                                                                      |
| lang <span style="{color: &#x22;red&#x22;}">\*</span>    | string            | You can set language for e.g. `en` for english `fr` for french.<br />Get the list of available languages by making a separate request to the [Languages List](/extra-apis/languages-list)                                                                                                                                  |
| loc <span style="{color: &#x22;red&#x22;}">\*</span>     | string            | Optional field if you specify `loc_id`<br />&#x2A;*You must choose one of the fields: `loc_id` or `loc`**<br />You can receive the list of available locations of search engines with their loc\_id by making a separate request to the [Locations List](/extra-apis/locations-list)                                       |
| loc\_id <span style="{color: &#x22;red&#x22;}">\*</span> | integer           | Optional field if you specify `loc`<br />&#x2A;*You must choose one of the fields: `loc_id` or `loc`**<br />You can receive the list of available locations of search engines with their loc\_id by making a separate request to the [Locations List](/extra-apis/locations-list)                                          |
| page                                                     | integer           | Give specific page to get the result of that page number. By default it will get you first page.                                                                                                                                                                                                                           |
| date\_range                                              | String            | Sometimes you may want to only find information published during a specific time frame. To limit Google results by date<br /><br />Parameter values can be comma separated date range `YYYY-MM-DD,YYYY-MM-DD` OR<br /><br />`h` Past hour<br />`d` Past 24 hours<br />`w` Past week<br />`m` Past month<br />`y` Past year |
| no\_trace                                                | string \| integer | Enterprise only. Enables NoTrace mode. Accepted values: `0`, `1`, `true`, and `false`. When enabled (`1` or `true`), search parameters, files, and metadata are not stored on our servers.                                                                                                                                 |

<VisualRef title="Google News API" src="/images/google/google-news-api.png" alt="Google news search results" />

## Example Request [#example-request]

<ApiExample endpoint="https://api.serphouse.com/google-news" query="top headlines" domain="google.com" lang="en" params="{&#x22;device&#x22;: &#x22;desktop&#x22;, &#x22;loc&#x22;: &#x22;United Kingdom&#x22;}" />

## Example Response [#example-response]

<ApiExample mode="response">
  <ApiTab label="JSON" response="googleNewsJsonResponse" />

  <ApiTab label="Markdown" response="googleNewsMarkdownResponse" lang="markdown" />
</ApiExample>

## Related Links [#related-links]

<Cards>
  <Card title="Google Search API" href="/google-apis/google-search-api" />

  <Card title="Google Image API" href="/google-apis/google-image-api" />
</Cards>