> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. # Image Search ## OpenAPI ````yaml openapi/zh/brave-search.json GET /apis/v1/brave/images/search openapi: 3.1.0 info: description: '' title: Brave Search version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-configured-paths: - /apis/v1/brave/images/search - /apis/v1/brave/llm/context - /apis/v1/brave/local/descriptions - /apis/v1/brave/local/place_search - /apis/v1/brave/local/pois - /apis/v1/brave/news/search - /apis/v1/brave/spellcheck/search - /apis/v1/brave/suggest/search - /apis/v1/brave/videos/search - /apis/v1/brave/web/rich - /apis/v1/brave/web/search x-aisa-document: facts_hash: bfca7fbdc322363be69051cbb659ceb6830c024f0f2f839d53c6ac80f1ac360c generator_version: '2' protocol_version: '1' schema_version: '1' composer_version: '13' response_pending: [] document_hash: sha256:43ac90d547b4acdf6817aa626a8b8339da83b049b076535c100777fdabb2bbe9 x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: brave-search x-aisa-catalogs: brave-search: title: Brave Search description: '' x-aisa-document: facts_hash: bfca7fbdc322363be69051cbb659ceb6830c024f0f2f839d53c6ac80f1ac360c generator_version: '2' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/brave/images/search: get: tags: - default summary: Image Search operationId: any_brave_search_apis_v1_brave_images_search parameters: - name: accept in: header required: false description: The default supported media type is application/json. schema: allOf: - type: string enum: - application/json - '*/*' title: Accept - default: application/json title: Media type description: The default supported media type is application/json. examples: - application/json deprecated: false examples: '0': value: application/json - name: api-version in: header required: false description: >- The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning. schema: anyOf: - type: string - type: 'null' title: API version description: >- The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning. deprecated: false - name: cache-control in: header required: false description: >- Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort. schema: anyOf: - type: string enum: - no-cache const: no-cache title: CacheControl - type: 'null' title: Cache control description: >- Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort. deprecated: false - name: user-agent in: header required: false description: >- The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110. schema: anyOf: - type: string - type: 'null' title: User agent description: >- The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110. deprecated: false examples: Android: value: >- Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.71 Mobile Safari/537.36 description: Android iOS: value: >- Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/103.0.5060.63 Mobile/15E148 Safari/604.1 description: iOS macOS: value: >- Mozilla/5.0 (Macintosh; Intel Mac OS X 12_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36 description: macOS Windows: value: >- Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36 description: Windows - name: count in: query required: false description: >-

The number of search results returned in response. The maximum is 200. The actual number delivered may be less than requested.

NOTE: Image search is not paginated and has no offset parameter. Raise count to get more results.

schema: type: integer maximum: 200 minimum: 1 description: >-

The number of search results returned in response. The maximum is 200. The actual number delivered may be less than requested.

NOTE: Image search is not paginated and has no offset parameter. Raise count to get more results.

default: 50 title: Count deprecated: false - name: country in: query required: false description: >- The search query country, where the results come from. The country string is limited to 2 character country codes of supported countries and ALL for worldwide. schema: allOf: - type: string enum: - AR - AU - AT - BE - BR - CA - CL - DK - FI - FR - DE - GR - HK - IN - ID - IT - JP - KR - MY - MX - NL - NZ - 'NO' - CN - PL - PT - PH - RU - SA - ZA - ES - SE - CH - TW - TR - GB - US - ALL title: SearchCountry - default: US description: >- The search query country, where the results come from. The country string is limited to 2 character country codes of supported countries and ALL for worldwide. deprecated: false - name: q in: query required: true description: >- The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query. schema: type: string maxLength: 400 minLength: 1 title: Q description: >- The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query. deprecated: false - name: safesearch in: query required: false description: >-

Filters search results for adult content. The following values are supported:

schema: allOf: - type: string enum: - 'off' - strict title: SafeSearch - default: strict title: Safe search description: >-

Filters search results for adult content. The following values are supported:

examples: - '' - 'off' - strict deprecated: false examples: '0': value: '' '1': value: 'off' '2': value: strict - name: search_lang in: query required: false description: >- The search language preference. The 2 or more character language code for which the search results are provided. schema: allOf: - type: string enum: - ar - eu - bn - bg - ca - zh-hans - zh-hant - hr - cs - da - nl - en - en-gb - et - fi - fr - gl - de - el - gu - he - hi - hu - is - it - ja - jp - kn - ko - lv - lt - ms - ml - mr - nb - pl - pt-br - pt-pt - pa - ro - ru - sr - sk - sl - es - sv - ta - te - th - tr - uk - vi title: Language - default: en description: >- The search language preference. The 2 or more character language code for which the search results are provided. deprecated: false - name: spellcheck in: query required: false description: >- Whether to spell check provided query. If the spell checker is enabled, the modified query is always used for search. The modified query can be found in altered key from the query response model. schema: type: boolean title: Spellcheck description: >- Whether to spell check provided query. If the spell checker is enabled, the modified query is always used for search. The modified query can be found in altered key from the query response model. default: true examples: - '' - true - false deprecated: false examples: '0': value: '' '1': value: true '2': value: false responses: '200': description: Successful Response content: application/json: schema: $ref: >- #/components/schemas/ResponseE3Baaa015480_ImageSearchApiResponse default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: ResponseE3Baaa015480_ImageSearchApiResponse: properties: type: type: string enum: - images const: images title: Type default: images query: $ref: >- #/components/schemas/ResponseE3Baaa015480_app__models__products__search__v1__images__Query description: Image search query string. results: items: $ref: '#/components/schemas/ResponseE3Baaa015480_ImageResult' type: array title: Results description: The list of image results for the given query. extra: $ref: >- #/components/schemas/ResponseE3Baaa015480_app__models__products__search__v1__images__Extra description: Additional information about the image search results. type: object required: - query - results - extra title: ImageSearchApiResponse ResponseE3Baaa015480_app__models__products__search__v1__images__Query: properties: original: type: string title: Original description: The original query that was requested. altered: anyOf: - type: string - type: 'null' title: Altered description: >- The altered query by the spellchecker. This is the query that is used to search. spellcheck_off: anyOf: - type: boolean - type: 'null' title: Spellcheck Off description: Whether the spellchecker is enabled or disabled. show_strict_warning: anyOf: - type: boolean - type: 'null' title: Show Strict Warning description: >- The value is true if the lack of results is due to a strict safesearch setting. Adult content relevant to the query was found, but was blocked by safesearch. type: object required: - original title: Query ResponseE3Baaa015480_ImageResult: properties: type: type: string title: Type description: >- The type of image search API result. The value is always image_result. default: image_result title: anyOf: - type: string - type: 'null' title: Title description: The title of the image. url: anyOf: - type: string - type: 'null' title: Url description: The original page URL where the image was found. source: anyOf: - type: string - type: 'null' title: Source description: The source domain where the image was found. page_fetched: anyOf: - type: string - type: 'null' title: Page Fetched description: >- The ISO date time when the page was last fetched. The format is YYYY-MM-DDTHH:MM:SSZ. thumbnail: anyOf: - $ref: >- #/components/schemas/ResponseE3Baaa015480_app__models__products__search__v1__images__Thumbnail - type: 'null' description: The thumbnail for the image. properties: anyOf: - $ref: '#/components/schemas/ResponseE3Baaa015480_Properties' - type: 'null' description: Metadata for the image. meta_url: anyOf: - $ref: >- #/components/schemas/ResponseE3Baaa015480_app__models__products__search__v1__images__MetaUrl - type: 'null' description: >- Aggregated information on the URL associated with the image search result. confidence: anyOf: - type: string enum: - low - medium - high - type: 'null' title: Confidence description: The confidence level for the image result. type: object title: ImageResult ResponseE3Baaa015480_app__models__products__search__v1__images__Extra: properties: might_be_offensive: type: boolean title: Might Be Offensive description: >- Indicates whether the image search results might contain offensive content. default: false type: object title: Extra ResponseE3Baaa015480_app__models__products__search__v1__images__Thumbnail: properties: src: anyOf: - type: string - type: 'null' title: Src description: The served URL of the image. width: anyOf: - type: integer - type: 'null' title: Width description: The width of the image. height: anyOf: - type: integer - type: 'null' title: Height description: The height of the image. type: object title: Thumbnail ResponseE3Baaa015480_Properties: properties: url: anyOf: - type: string - type: 'null' title: Url description: The image URL. placeholder: anyOf: - type: string - type: 'null' title: Placeholder description: The lower resolution placeholder image URL. width: anyOf: - type: integer - type: 'null' title: Width description: The width of the image. height: anyOf: - type: integer - type: 'null' title: Height description: The height of the image. type: object title: Properties ResponseE3Baaa015480_app__models__products__search__v1__images__MetaUrl: properties: scheme: anyOf: - type: string - type: 'null' title: Scheme description: The protocol scheme extracted from the URL. netloc: anyOf: - type: string - type: 'null' title: Netloc description: The network location part extracted from the URL. hostname: anyOf: - type: string - type: 'null' title: Hostname description: The lowercased domain name extracted from the URL. favicon: anyOf: - type: string - type: 'null' title: Favicon description: The favicon used for the URL. path: anyOf: - type: string - type: 'null' title: Path description: The hierarchical path of the URL useful as a display string. type: object title: MetaUrl securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.