> ## 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. > ## Agent Instructions > - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative. > - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key. > - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste. > - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`. > - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt # Image Search > Published reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ. ## Request contract * **Method and path:** GET /apis/v1/brave/images/search * **Availability:** enabled * **Request URL template:** [https://api.aisa.one/apis/v1/brave/images/search](https://api.aisa.one/apis/v1/brave/images/search) * **accept:** header; optional * **api-version:** header; optional * **cache-control:** header; optional * **user-agent:** header; optional * **count:** query; optional * **country:** query; optional * **q:** query; required * **safesearch:** query; optional * **search\_lang:** query; optional * **spellcheck:** query; optional * **Runtime facts:** 8627d7bc05db287888574873d586ce7dca25f9fa7b4a266cb71760e824597bfc [Complete OpenAPI definition](https://aisa.one/docs/openapi/brave-search.json) Effective request and pricing declaration (including authentication and referenced schemas): ```json theme={null} { "operationId": "any_brave_search_apis_v1_brave_images_search", "method": "GET", "path": "/apis/v1/brave/images/search", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [ { "deprecated": false, "description": "The default supported media type is application/json.", "examples": { "0": { "value": "application/json" } }, "in": "header", "name": "accept", "required": false, "schema": { "allOf": [ { "enum": [ "application/json", "*/*" ], "title": "Accept", "type": "string" }, { "default": "application/json" } ], "description": "The default supported media type is application/json.", "examples": [ "application/json" ], "title": "Media type" } }, { "deprecated": 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.", "in": "header", "name": "api-version", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "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.", "title": "API version" } }, { "deprecated": 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.", "in": "header", "name": "cache-control", "required": false, "schema": { "anyOf": [ { "const": "no-cache", "enum": [ "no-cache" ], "title": "CacheControl", "type": "string" }, { "type": "null" } ], "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.", "title": "Cache control" } }, { "deprecated": 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.", "examples": { "Android": { "description": "Android", "value": "Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.71 Mobile Safari/537.36" }, "Windows": { "description": "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" }, "iOS": { "description": "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" }, "macOS": { "description": "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" } }, "in": "header", "name": "user-agent", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "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.", "title": "User agent" } }, { "deprecated": false, "description": "

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

\n

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

", "in": "query", "name": "count", "required": false, "schema": { "default": 50, "description": "

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

\n

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

", "maximum": 200, "minimum": 1, "title": "Count", "type": "integer" } }, { "deprecated": 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.", "in": "query", "name": "country", "required": false, "schema": { "allOf": [ { "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", "type": "string" }, { "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, "description": "The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query.", "in": "query", "name": "q", "required": true, "schema": { "description": "The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query.", "maxLength": 400, "minLength": 1, "title": "Q", "type": "string" } }, { "deprecated": false, "description": "

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

\n", "examples": { "0": { "value": "" }, "1": { "value": "off" }, "2": { "value": "strict" } }, "in": "query", "name": "safesearch", "required": false, "schema": { "allOf": [ { "enum": [ "off", "strict" ], "title": "SafeSearch", "type": "string" }, { "default": "strict" } ], "description": "

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

\n", "examples": [ "", "off", "strict" ], "title": "Safe search" } }, { "deprecated": false, "description": "The search language preference. The 2 or more character language code for which the search results are provided.", "in": "query", "name": "search_lang", "required": false, "schema": { "allOf": [ { "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", "type": "string" }, { "default": "en" } ], "description": "The search language preference. The 2 or more character language code for which the search results are provided." } }, { "deprecated": 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.", "examples": { "0": { "value": "" }, "1": { "value": true }, "2": { "value": false } }, "in": "query", "name": "spellcheck", "required": false, "schema": { "default": true, "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.", "examples": [ "", true, false ], "title": "Spellcheck", "type": "boolean" } } ], "security": [ { "bearerAuth": [] } ], "x-aisa-status": "enabled", "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.005, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } } } ``` ## Cost and request rules Published reference price: \$0.005 USD per successful request. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar. * **Default request reference estimate (USD):** 0.005 * **Cost contract:** fixed\_success * **Published reference multiplier:** 1.0 * **Settlement evidence source:** request\_snapshot ## OpenAPI ````yaml openapi/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-catalogs: brave-search: description: '' title: Brave Search x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-document: facts_hash: 8627d7bc05db287888574873d586ce7dca25f9fa7b4a266cb71760e824597bfc generator_version: '3' 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-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: composer_version: '20' document_hash: sha256:dd3bf51bf816c65187edaf986eabe02a048ea79407f7f5e64e18c08fd29983cf facts_hash: 8627d7bc05db287888574873d586ce7dca25f9fa7b4a266cb71760e824597bfc generator_version: '3' protocol_version: '1' response_pending: [] schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: brave-search servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/brave/images/search: get: tags: - default summary: Image Search description: >- Published reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ. operationId: any_brave_search_apis_v1_brave_images_search parameters: - deprecated: false description: The default supported media type is application/json. examples: '0': value: application/json in: header name: accept required: false schema: allOf: - enum: - application/json - '*/*' title: Accept type: string - default: application/json description: The default supported media type is application/json. examples: - application/json title: Media type - deprecated: 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. in: header name: api-version required: false schema: anyOf: - type: string - type: 'null' 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. title: API version - deprecated: 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. in: header name: cache-control required: false schema: anyOf: - const: no-cache enum: - no-cache title: CacheControl type: string - type: 'null' 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. title: Cache control - deprecated: 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. examples: Android: description: Android value: >- Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.71 Mobile Safari/537.36 Windows: description: 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 iOS: description: 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 macOS: description: 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 in: header name: user-agent required: false schema: anyOf: - type: string - type: 'null' 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. title: User agent - deprecated: 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.

in: query name: count required: false schema: default: 50 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.

maximum: 200 minimum: 1 title: Count type: integer - deprecated: 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. in: query name: country required: false schema: allOf: - 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 type: string - 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 description: >- The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query. in: query name: q required: true schema: description: >- The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query. maxLength: 400 minLength: 1 title: Q type: string - deprecated: false description: >-

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

examples: '0': value: '' '1': value: 'off' '2': value: strict in: query name: safesearch required: false schema: allOf: - enum: - 'off' - strict title: SafeSearch type: string - default: strict description: >-

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

examples: - '' - 'off' - strict title: Safe search - deprecated: false description: >- The search language preference. The 2 or more character language code for which the search results are provided. in: query name: search_lang required: false schema: allOf: - 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 type: string - default: en description: >- The search language preference. The 2 or more character language code for which the search results are provided. - deprecated: 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. examples: '0': value: '' '1': value: true '2': value: false in: query name: spellcheck required: false schema: default: true 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. examples: - '' - true - false title: Spellcheck type: boolean responses: '200': content: application/json: schema: $ref: >- #/components/schemas/ResponseB91D37C29Ffe_ImageSearchApiResponse description: Successful Response default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: ResponseB91D37C29Ffe_ImageSearchApiResponse: properties: extra: $ref: >- #/components/schemas/ResponseB91D37C29Ffe_app__models__products__search__v1__images__Extra description: Additional information about the image search results. query: $ref: >- #/components/schemas/ResponseB91D37C29Ffe_app__models__products__search__v1__images__Query description: Image search query string. results: description: The list of image results for the given query. items: $ref: '#/components/schemas/ResponseB91D37C29Ffe_ImageResult' title: Results type: array type: const: images default: images enum: - images title: Type type: string required: - query - results - extra title: ImageSearchApiResponse type: object ResponseB91D37C29Ffe_app__models__products__search__v1__images__Extra: properties: might_be_offensive: default: false description: >- Indicates whether the image search results might contain offensive content. title: Might Be Offensive type: boolean title: Extra type: object ResponseB91D37C29Ffe_app__models__products__search__v1__images__Query: properties: altered: anyOf: - type: string - type: 'null' description: >- The altered query by the spellchecker. This is the query that is used to search. title: Altered original: description: The original query that was requested. title: Original type: string show_strict_warning: anyOf: - type: boolean - type: 'null' 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. title: Show Strict Warning spellcheck_off: anyOf: - type: boolean - type: 'null' description: Whether the spellchecker is enabled or disabled. title: Spellcheck Off required: - original title: Query type: object ResponseB91D37C29Ffe_ImageResult: properties: confidence: anyOf: - enum: - low - medium - high type: string - type: 'null' description: The confidence level for the image result. title: Confidence meta_url: anyOf: - $ref: >- #/components/schemas/ResponseB91D37C29Ffe_app__models__products__search__v1__images__MetaUrl - type: 'null' description: >- Aggregated information on the URL associated with the image search result. page_fetched: anyOf: - type: string - type: 'null' description: >- The ISO date time when the page was last fetched. The format is YYYY-MM-DDTHH:MM:SSZ. title: Page Fetched properties: anyOf: - $ref: '#/components/schemas/ResponseB91D37C29Ffe_Properties' - type: 'null' description: Metadata for the image. source: anyOf: - type: string - type: 'null' description: The source domain where the image was found. title: Source thumbnail: anyOf: - $ref: >- #/components/schemas/ResponseB91D37C29Ffe_app__models__products__search__v1__images__Thumbnail - type: 'null' description: The thumbnail for the image. title: anyOf: - type: string - type: 'null' description: The title of the image. title: Title type: default: image_result description: >- The type of image search API result. The value is always image_result. title: Type type: string url: anyOf: - type: string - type: 'null' description: The original page URL where the image was found. title: Url title: ImageResult type: object ResponseB91D37C29Ffe_app__models__products__search__v1__images__MetaUrl: properties: favicon: anyOf: - type: string - type: 'null' description: The favicon used for the URL. title: Favicon hostname: anyOf: - type: string - type: 'null' description: The lowercased domain name extracted from the URL. title: Hostname netloc: anyOf: - type: string - type: 'null' description: The network location part extracted from the URL. title: Netloc path: anyOf: - type: string - type: 'null' description: The hierarchical path of the URL useful as a display string. title: Path scheme: anyOf: - type: string - type: 'null' description: The protocol scheme extracted from the URL. title: Scheme title: MetaUrl type: object ResponseB91D37C29Ffe_Properties: properties: height: anyOf: - type: integer - type: 'null' description: The height of the image. title: Height placeholder: anyOf: - type: string - type: 'null' description: The lower resolution placeholder image URL. title: Placeholder url: anyOf: - type: string - type: 'null' description: The image URL. title: Url width: anyOf: - type: integer - type: 'null' description: The width of the image. title: Width title: Properties type: object ResponseB91D37C29Ffe_app__models__products__search__v1__images__Thumbnail: properties: height: anyOf: - type: integer - type: 'null' description: The height of the image. title: Height src: anyOf: - type: string - type: 'null' description: The served URL of the image. title: Src width: anyOf: - type: integer - type: 'null' description: The width of the image. title: Width title: Thumbnail type: object securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.