Brave
Search Brave news results
Returns Brave news search results for a query string. Locale defaults to country=us and lang=en-us. Returns 503 when Brave serves a challenge page or unusable results.
get/brave/news
Request
- Base URL: https://api.crawlora.net/api/v1
- URL: https://api.crawlora.net/api/v1/brave/news
- Auth: API key in header x-api-key
Query parameters
qstring required
Search query
offsetinteger
Zero-based Brave result page; defaults to 0
countinteger
Results to return; defaults to 10, clamped to 1..50
country'all' | 'ar' | 'at' | 'au' | 'be' | 'br' | 'ca' | 'ch' | 'cl' | 'cn' | 'de' | 'dk' | 'es' | 'fi' | 'fr' | 'gb' | 'gr' | 'hk' | 'id' | 'in' | 'it' | 'jp' | 'kr' | 'mx' | 'my' | 'nl' | 'no' | 'nz' | 'ph' | 'pl' | 'pt' | 'ru' | 'sa' | 'se' | 'sg' | 'tr' | 'tw' | 'us' | 'za'
Brave result country; defaults to us
lang'de-de' | 'en-ca' | 'en-gb' | 'en-in' | 'en-us' | 'fi-fi' | 'fr-ca' | 'fr-fr' | 'ja-jp' | 'pt-br' | 'sq-al' | 'sw-ke' | 'zh-tw'
Brave UI language; defaults to en-us
time_range'any' | 'day' | 'week' | 'month' | 'year' | 'custom'
Preset time filter: any, day, week, month, year, or custom
date_fromstring
Custom start date in YYYY-MM-DD; requires date_to
date_tostring
Custom end date in YYYY-MM-DD; requires date_from
Headers
x-api-keystring required
API key required
Response
OK
Example response
{
"code": 200,
"data": {
"pagination": {
"next_offset": 1
},
"results": [
{
"age": "2 hours ago",
"description": "OpenAI announced an update.",
"favicon": "https://imgs.search.brave.com/example.ico",
"hostname": "www.example.com",
"path": "technology > ai",
"position": 1,
"source": "Reuters",
"thumbnail": "https://imgs.search.brave.com/example-thumb.jpg",
"title": "OpenAI announces update",
"url": "https://example.com/openai-news"
}
]
},
"msg": "OK"
}Changes
No recorded changes to this operation across all 3 revisions of this API.