Brave News Search API
Response Objects
# NewsSearchApiResponse
Top level response model for successful News Search API requests. The API can also respond back with an error response based on invalid subscription keys and rate limit events.
| Field | Type | Description |
|---|---|---|
| type | "news" | The type of search API result. The value is always news. |
| query | Query | News search query string. |
| results | list [ NewsResult ] | The list of news results for the given query. |
# Query
A model representing information gathered around the requested query.
| Field | Type | Description |
|---|---|---|
| original | string | The original query that was requested. |
| altered | string | The altered query by the spellchecker. This is the query that is used to search if any. |
| cleaned | string | The cleaned noramlized query by the spellchecker. This is the query that is used to search if any. |
| spellcheck_off | bool | Whether the spell checker is enabled or disabled. |
| show_strict_warning | string | The value is True if the lack of results is due to a 'strict' safesearch setting. Adult content relevant to the query was found, but was blocked by safesearch. |
# NewsResult
A model representing a news result for the requested query.
| Field | Type | Description |
|---|---|---|
| type | news_result | The type of news search API result. The value is always news_result. |
| url | string | The source url of the news article. |
| title | string | The title of the news article. |
| description | string | The description for the news article. |
| age | string | A human readable representation of the page age. |
| page_age | string | The page age found from the source web page. |
| page_fetched | string | The iso date time when the page was last fetched. The format is YYYY-MM-DDTHH:MM:SSZ |
| breaking | bool | Whether the result includes breaking news. |
| thumbnail | Thumbnail | The thumbnail for the news article. |
| meta_url | MetaUrl | Aggregated information on the url associated with the news search result. |
| extra_snippets | list [ string ] | A list of extra alternate snippets for the news search result. |
# Thumbnail
Aggregated details representing the news thumbnail
| Field | Type | Description |
|---|---|---|
| src | string | The served url of the thumbnail associated with the news article. |
| original | string | The original url of the thumbnail associated with the news article. |
# MetaUrl
Aggregated information about a url.
| Field | Type | Description |
|---|---|---|
| scheme | string | The protocol scheme extracted from the url. |
| netloc | string | The network location part extracted from the url. |
| hostname | string | The lowercased domain name extracted from the url. |
| favicon | string | The favicon used for the url. |
| path | string | The hierarchical path of the url useful as a display string. |