### Complete Search Request Example Source: https://api-dashboard.search.brave.com/app/documentation/image-search/get-started An example demonstrating how to combine multiple parameters for a comprehensive image search. ```APIDOC ## Example: Complete Search Request ### Description This example demonstrates a comprehensive image search request combining multiple parameters. ### Method GET ### Endpoint https://api.search.brave.com/res/v1/images/search ### Parameters #### Query Parameters - **q** (string) - Required - The search query term (e.g., `modern architecture`). - **country** (string) - Optional - Target images from a specific country (e.g., `US`). - **search_lang** (string) - Optional - Prefer results in a specific language (e.g., `en`). - **count** (integer) - Optional - The desired number of images to retrieve (e.g., `150`). - **safesearch** (string) - Optional - Safe search filter setting (e.g., `strict`). #### Headers - **X-Subscription-Token** (string) - Required - Your API key. ### Request Example ```bash curl "https://api.search.brave.com/res/v1/images/search?q=modern+architecture&country=US&search_lang=en&count=150&safesearch=strict" \ -H "X-Subscription-Token: " ``` ``` -------------------------------- ### Perform a Basic Image Search Source: https://api-dashboard.search.brave.com/app/documentation/image-search/get-started Initiate a simple image search by providing a query. Ensure you replace '' with your actual subscription token. ```curl curl "https://api.search.brave.com/res/v1/images/search?q=mountain+landscape" \ -H "X-Subscription-Token: " ``` -------------------------------- ### Target Images by Country and Language Source: https://api-dashboard.search.brave.com/app/documentation/image-search/get-started Customize search results by specifying the country code (e.g., 'JP') and search language (e.g., 'ja'). Replace '' with your token. ```curl curl "https://api.search.brave.com/res/v1/images/search?q=桜&country=JP&search_lang=ja" \ -H "X-Subscription-Token: " ``` -------------------------------- ### Comprehensive Image Search Request Source: https://api-dashboard.search.brave.com/app/documentation/image-search/get-started Combine multiple parameters including query, country, language, result count, and safe search settings for a tailored search. Replace '' with your token. ```curl curl "https://api.search.brave.com/res/v1/images/search?q=modern+architecture&country=US&search_lang=en&count=150&safesearch=strict" \ -H "X-Subscription-Token: " ``` -------------------------------- ### Control Image Result Count Source: https://api-dashboard.search.brave.com/app/documentation/image-search/get-started Request a specific number of images, up to a maximum of 200. The default is 50. Replace '' with your token. ```curl curl "https://api.search.brave.com/res/v1/images/search?q=wildlife+photography&count=100" \ -H "X-Subscription-Token: " ``` -------------------------------- ### Basic Image Search Source: https://api-dashboard.search.brave.com/app/documentation/image-search/get-started Perform a basic image search by providing a query term. ```APIDOC ## Basic Image Search ### Description Get started with a simple image search request by providing a query parameter `q`. ### Method GET ### Endpoint https://api.search.brave.com/res/v1/images/search ### Parameters #### Query Parameters - **q** (string) - Required - The search query term. #### Headers - **X-Subscription-Token** (string) - Required - Your API key. ### Request Example ```bash curl "https://api.search.brave.com/res/v1/images/search?q=mountain+landscape" \ -H "X-Subscription-Token: " ``` ``` -------------------------------- ### Country and Language Targeting Source: https://api-dashboard.search.brave.com/app/documentation/image-search/get-started Customize search results by specifying country and preferred search language. ```APIDOC ## Country and Language Targeting ### Description Customize your image search results by specifying the country and search language. ### Method GET ### Endpoint https://api.search.brave.com/res/v1/images/search ### Parameters #### Query Parameters - **q** (string) - Required - The search query term. - **country** (string) - Optional - Prefer images from specific countries using country codes (e.g., `JP`) or `ALL` for worldwide. - **search_lang** (string) - Optional - Prefer results by content language (e.g., `ja`). #### Headers - **X-Subscription-Token** (string) - Required - Your API key. ### Request Example ```bash curl "https://api.search.brave.com/res/v1/images/search?q=桜&country=JP&search_lang=ja" \ -H "X-Subscription-Token: " ``` ``` -------------------------------- ### Disable Safe Search Source: https://api-dashboard.search.brave.com/app/documentation/image-search/get-started Disable the default strict safe search filtering to include all content, except illegal material. Use with caution. Replace '' with your token. ```curl curl "https://api.search.brave.com/res/v1/images/search?q=art&safesearch=off" \ -H "X-Subscription-Token: " ``` -------------------------------- ### Disable Spellcheck Source: https://api-dashboard.search.brave.com/app/documentation/image-search/get-started Turn off the automatic spellcheck functionality by setting 'spellcheck' to 'false'. Replace '' with your token. ```curl curl "https://api.search.brave.com/res/v1/images/search?q=architecure&spellcheck=false" \ -H "X-Subscription-Token: " ``` -------------------------------- ### Safe Search Control Source: https://api-dashboard.search.brave.com/app/documentation/image-search/get-started Adjust the safe search filter to control the type of content returned. ```APIDOC ## Safe Search ### Description Image Search prioritizes safe content with strict filtering by default. You can adjust this setting. ### Method GET ### Endpoint https://api.search.brave.com/res/v1/images/search ### Parameters #### Query Parameters - **q** (string) - Required - The search query term. - **safesearch** (string) - Optional - Controls safe search filtering. Options: `strict` (default, drops adult content), `off` (no filtering except for illegal content). #### Headers - **X-Subscription-Token** (string) - Required - Your API key. ### Request Example ```bash curl "https://api.search.brave.com/res/v1/images/search?q=art&safesearch=off" \ -H "X-Subscription-Token: " ``` ### Note Disabling safe search may return adult or inappropriate content. Use with caution. ``` -------------------------------- ### Result Count Control Source: https://api-dashboard.search.brave.com/app/documentation/image-search/get-started Control the number of images returned in the search results, up to a maximum of 200. ```APIDOC ## Result Count Control ### Description Control the number of images returned per request. The default is 50, with a maximum of 200. ### Method GET ### Endpoint https://api.search.brave.com/res/v1/images/search ### Parameters #### Query Parameters - **q** (string) - Required - The search query term. - **count** (integer) - Optional - The desired number of images to retrieve (default: 50, max: 200). #### Headers - **X-Subscription-Token** (string) - Required - Your API key. ### Request Example ```bash curl "https://api.search.brave.com/res/v1/images/search?q=wildlife+photography&count=100" \ -H "X-Subscription-Token: " ``` ### Note The actual number of images returned may be less than requested based on available results. ``` -------------------------------- ### Disable Spellcheck Source: https://api-dashboard.search.brave.com/app/documentation/image-search/get-started Optionally disable the automatic spellcheck functionality for image searches. ```APIDOC ## Spellcheck ### Description Image Search includes automatic spellcheck functionality by default. You can disable it if needed. ### Method GET ### Endpoint https://api.search.brave.com/res/v1/images/search ### Parameters #### Query Parameters - **q** (string) - Required - The search query term. - **spellcheck** (boolean) - Optional - Set to `false` to disable automatic spellcheck. #### Headers - **X-Subscription-Token** (string) - Required - Your API key. ### Request Example ```bash curl "https://api.search.brave.com/res/v1/images/search?q=architecure&spellcheck=false" \ -H "X-Subscription-Token: " ``` ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.