---
title: "Search for images using the Brave Search"
method: POST
path: "/imageSearch"
---

# Search for images using the Brave Search

`POST /imageSearch`

Search for images using the Brave Search (with a query upto 20 images per toolcall)

## Request body

- object
  - `body` object — Body of the imageSearch sls call
    - `arguments` object, required — Parameters for the image search function
      - `q` string, required — The search query
      - `country` string — Two-letter country code (e.g., 'US', 'GB')
      - `search_lang` string — Language for search results
      - `ui_lang` string — Language for user interface elements
      - `count` integer — Number of results to return
      - `offset` integer — Pagination offset
      - `safesearch` 'off' | 'moderate' | 'strict' — Content filtering level
      - `freshness` union — Result freshness filter
        - 'pd' | 'pw' | 'pm' | 'py'
        - string
      - `text_decorations` boolean — Include text decoration markers in results
      - `spellcheck` boolean — Enable automatic spell checking
      - `result_filter` string — Comma-separated list of result types to include
      - `goggles` string[] — Array of goggle definitions
      - `units` 'metric' | 'imperial' — Measurement units

## Response `200`

Successful image search response

- object
  - `query` object
    - `original` string
    - `show_strict_warning` boolean
    - `is_navigational` boolean
    - `is_news_breaking` boolean
    - `spellcheck_off` boolean
    - `country` string
    - `bad_results` boolean
    - `should_fallback` boolean
    - `postal_code` string
    - `city` string
    - `header_country` string
    - `more_results_available` boolean
    - `state` string
  - `mixed` object
    - `type` string
    - `main` object[]
      - `title` string
      - `url` string
      - `source` string
      - `source_favicon` string
      - `source_domain` string
      - `thumbnail` object
        - `src` string
        - `original` string
        - `width` number
        - `height` number
      - `size` object
        - `width` number
        - `height` number
      - `age` string
      - `type` string
      - `description` string
      - `family_friendly` boolean
  - `type` string

## Other responses

- `400` — Bad request - invalid parameters
- `401` — Unauthorized - invalid or missing API key
- `429` — Too many requests - rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/microfox-ai/apis/brave-search.md) · [All operations](https://skmtc.net/microfox-ai/apis/brave-search/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/microfox-ai/brave-search/versions/2284eaa411cf/schema)