Query Parameters
# News Search API
This table lists the query parameters supported by the News Search API. Some are required, but most are optional.
Parameter | Required | Type | Default | Description |
---|---|---|---|---|
q | yes | string | none | The user's search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query. |
country | no | string | us | The search query country, where the results come from. The country string is limited to 2 character country codes of supported countries. For a list of supported values, see Country Codes. |
search_lang | no | string | en | The search language preference. The 2 or more character language code for which the search results are provided. For a list of possible values, see Language Codes. |
ui_lang | no | string | en-US | User interface language preferred in response. Usually of the format |
count | no | int | 20 | The number of search results returned in response. The maximum is |
offset | no | int | 0 | The zero-based offset that indicates the number of news search results per page
(count) to skip before returning the result. The maximum is
In order to paginate results use this parameter together with |
safesearch | no | string | strict | Filters search results for adult content. The following values are supported:
|
spellcheck | no | bool | 1 | Whether to enable spell checker. |
freshness | no | string | none | Filters news search results by when they were discovered. Defaults to
|
extra_snippets | no | bool | none | A snippet is an excerpt from a page you get as a result of the query, and extra_snippets
allow you to get up to 5 additional, alternative excerpts. Only available under
Free AI ,
Base AI , Pro AI , Base Data ,
Pro Data and Custom plans. |