Brave Images
Search Brave Images via API and retrieve structured image results with pagination and SafeSearch.
Credit cost: 1 credit per call
Authorization
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Query Parameters
query*string
The search query you want to run on Brave Images.
page?number
Page number for pagination (50 results per page).
Default
"1"gl?string
Country code (e.g. fr, us). Mapped to Brave country.
hl?string
Language code (e.g. fr, en). Mapped to Brave lang.
safe?string
SafeSearch: active | off | moderate | strict. Google-style active maps to Brave strict.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/brave/images?query=string"{ "images": [ { "url": "https://i.pinimg.com/originals/64/b2/43/64b24344ba1b61481e519a643ed926c8.jpg", "link": "https://www.pinterest.com/ideas/laws-of-motion-image/919633104944/", "title": "Newton's laws of motion", "domain": "www.pinterest.com", "source": "pinterest.com", "position": 1, "thumbnail": "https://imgs.search.brave.com/example/thumb.jpg", "image_width": 1100, "image_height": 850 } ], "search_parameters": { "q": "newton laws", "gl": "fr", "hl": "fr", "page": 1, "safe": "active", "engine": "brave_images", "safesearch": "strict" }}{ "error": "Bad Request"}{ "error": "Invalid API Key"}{ "error": "Payment required"}{ "error": "Rate limit exceeded for the API key: quota monthly"}{ "error": "Internal Error"}