> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapeunblocker.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Brave Images

> Runs Brave Images for `q` in a real browser and returns the image results as JSON, in the same shape as `/images/google-search`. Every result carries `imageUrl` (the origin image, not a thumbnail), `sourceDomain`, `sourcePageUrl`, `title`, `sourceName`, `thumbnailUrl`, `width` and `height`. Brave returns its whole result set (~200 images) on one page, billed as one request; `max_results` caps it.



## OpenAPI

````yaml /api-reference/openapi.json post /images/brave-search
openapi: 3.1.0
info:
  title: ScrapeUnblocker API
  description: >-
    Public API for the ScrapeUnblocker proxy/anti-bot service. Authenticate
    every request with the `x-scrapeunblocker-key` header. Documented here:
    page-source extraction, Google SERP scraping, image fetch, and the dedicated
    plugin endpoints (search engines, marketplaces, reviews, travel, social and
    more). All other paths exist for internal operations and are intentionally
    hidden from this spec.
  version: 3.0.0
servers:
  - url: https://api.scrapeunblocker.com
    description: Production
security: []
paths:
  /images/brave-search:
    post:
      tags:
        - Plugins
      summary: Search Brave Images
      description: >-
        Runs Brave Images for `q` in a real browser and returns the image
        results as JSON, in the same shape as `/images/google-search`. Every
        result carries `imageUrl` (the origin image, not a thumbnail),
        `sourceDomain`, `sourcePageUrl`, `title`, `sourceName`, `thumbnailUrl`,
        `width` and `height`. Brave returns its whole result set (~200 images)
        on one page, billed as one request; `max_results` caps it.
      operationId: brave_images_images_brave_search_post
      parameters:
        - name: q
          in: query
          required: true
          schema:
            type: string
            description: Image search term, e.g. 'eiffel tower'.
            title: Q
          description: Image search term, e.g. 'eiffel tower'.
        - name: max_results
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                maximum: 200
                minimum: 1
              - type: 'null'
            description: >-
              Optional cap on the number of results returned (default: all,
              ~200).
            title: Max Results
          description: 'Optional cap on the number of results returned (default: all, ~200).'
        - name: proxy_country
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Country to search from (ISO-2); Brave takes the region from it.
              Defaults to US.
            title: Proxy Country
          description: >-
            Country to search from (ISO-2); Brave takes the region from it.
            Defaults to US.
      responses:
        '200':
          description: JSON with a `results` array plus the query and counts.
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid parameters.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: Blocked by Brave or no image results returned.
        '504':
          description: Search timed out.
      security:
        - ScrapeUnblockerKey: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ScrapeUnblockerKey:
      type: apiKey
      in: header
      name: x-scrapeunblocker-key
      description: Your ScrapeUnblocker API key. Apply on every request.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.