Endpoint Playground
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.
14 Oct 2026: 40 results; 9 fields had a value in every checked item and 1 varied between items.
Sample value profiles: position: 1 to 40, median 20; url: “https://www.fool.com/investing/2026/10/13/broadcom-is-backi…” and 39 other values; thumbnail: imgs.search.brave.com.
curl "https://api.crawlora.net/api/v1/brave/news?q=openai&country=all&lang=de-de&time_range=any" \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | Yes | openai | Search query |
| offset | integer | No | Zero-based Brave result page; defaults to 0 | |
| count | integer | No | Results to return; defaults to 10, clamped to 1..50 | |
| country | string | No | all | Brave result country; defaults to us |
| lang | string | No | de-de | Brave UI language; defaults to en-us |
| time_range | string | No | any | Preset time filter: any, day, week, month, year, or custom |
| date_from | string | No | Custom start date in YYYY-MM-DD; requires date_to | |
| date_to | string | No | Custom end date in YYYY-MM-DD; requires date_from |
{
"code": 200,
"msg": "OK",
"data": {
"results": [
{
"position": 1,
"title": "OpenAI announces update",
"url": "https://example.com/openai-news",
"description": "OpenAI announced an update.",
"source": "Example News",
"hostname": "example.com",
"thumbnail": "https://imgs.search.brave.com/example-thumb.jpg",
"age": "2 hours ago"
}
],
"pagination": {
"offset": 0,
"next_offset": 1
}
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.