News
GET /search?search_type=news
The Google News Parameters are applicable when making a request with search_type=news to retrieve news results for a given search term. The search term is specified in the q parameter and the optional location parameter can be used to geo-locate the news request (locations can be retrieved via the Locations API).
You can use the time_period request parameter to refine your news search to specific time periods.
If you wish to exclude news results where Google have modified the original query set exclude_if_modified=true in your request parameters.
For example, to request news results for the keyword pizza in the location United States , the request would be:
The following parameters are available for all requests made when search_type=news .
Parameter | Required | Description |
|---|---|---|
search_type | required | Should be set to search_type=news . |
q | required | The keyword you want to use to perform the News search. |
location | optional | Determines the geographic location in which the query is executed. You can enter any location as free-text, but if you choose one of the VALUE SERP built-in locations then the google_domain , gl and hl parameters are automatically updated to the domain, country and language that match the built-in location (note that this behaviour can be disabled via the location_auto parameter). |
location_auto | optional | If the location field is set to a VALUE SERP built-in location from the Locations API , and location_auto is set to true (default) then the google_domain , gl and hl parameters are automatically updated to the domain, country and language that match the built-in location. Valid values are true (default) to enable this behaviour or false to disable. |
uule | optional | The Google UULE parameter - use to pass through a custom uule parameter to Google. VALUE SERP automatically generates the uule when you use the location parameter but we allow you to overwrite it directly by specifying a uule directly. |
google_domain | optional | The Google domain to use to run the search query. View the full list of supported google_domain values here . Defaults to google.com . |
gl | optional | The gl parameter determines the Google country to use for the query. View the full list of supported gl values here . Defaults to us . |
hl | optional | The hl parameter determines the Google UI language to return results. View the full list of supported hl values here . Defaults to en . |
lr | optional | The lr parameter limits the results to websites containing the specified language. View the full list of supported lr values here . |
cr | optional | The cr parameter instructs Google to limit the results to websites in the specified country. View the full list of supported cr values here . |
time_period | optional | Determines the time period of the results shown. It can be set to last_hour , last_day (for the last 24 hours), last_week (for the last 7 days), last_month , last_year or custom . When using custom you must also specifiy one or both of the time_period_min or time_period_max parameters to define the custom time period. |
time_period_min | optional | Determines the minimum (i.e. 'from') time to use when time_period is set to custom . Should be in the form MM/DD/YYYY , I.e. for 31st December 2018 time_period_min would be 12/31/2018 . |
time_period_max | optional | Determines the maximum (i.e. 'to') time to use when time_period is set to custom . Should be in the form MM/DD/YYYY , I.e. for 31st December 2018 time_period_max would be 12/31/2018 . |
nfpr | optional | Determines whether to exclude results from auto-corrected queries that were spelt wrong. Can be set to 1 to exclude auto-corrected results, or 0 (default) to include them. |
filter | optional | Determines if the filters for Similar Results and Omitted Results are on or off. Can be set to 1 (default) to enable these filters, or 0 to disable these filters. |
safe | optional | Determines whether Safe Search is enabled for the results. Can be set to active to enable Safe Search, or off to disable Safe Search. |
page | optional | Determines the page of results to return, defaults to 1 . Use in combination with the num parameter to implement pagination. |
max_page | optional | Use the max_page parameter to get multiple pages of results in one request. The API will automatically paginate through pages and concatenate the results into one response. See the Pagination docs for more information. |
num | optional | Determines the number of results to show per page. Use in combination with the page parameter to implement pagination. The maximum number of news results Google return per request is 100. |
tbs | optional | Sets a specific string to be added to the Google tbs parameter in the underlying Google query. The tbs parameter is normally generated automatically by the API, but it can be set explicitly also. |
sort_by | optional | Determines how results are sorted, valid values are relevance or date . Note that when sort_by=date the show_duplicates parameter can be used. |
show_duplicates | optional | Determines whether duplicates are shown in the news results. Must be used in conjunction with the sort_by parameter where sort_by is set to date . Valid values are true or false . Defaults to false . |
exclude_if_modified | optional | Determines whether the news_results returned when Google modifies the original query. Set to true to exclude news_results when Google modifies the original query or false (the default) to include news_results when Google modifies the original query. |
Next Steps Google News Results