---
title: "The Custom Image Search API lets you send an image search query to Bing and get image results found in your custom view of the web."
method: GET
path: "/images/search"
tags: ["CustomImageSearch"]
---

# The Custom Image Search API lets you send an image search query to Bing and get image results found in your custom view of the web.

`GET /images/search`

## Query parameters

- `customConfig` string, required
- `aspect` 'All' | 'Square' | 'Wide' | 'Tall'
- `color` 'ColorOnly' | 'Monochrome' | 'Black' | 'Blue' | 'Brown' | 'Gray' | 'Green' | 'Orange' | 'Pink' | 'Purple' | 'Red' | 'Teal' | 'White' | 'Yellow'
- `cc` string
- `count` integer
- `freshness` 'Day' | 'Week' | 'Month'
- `height` integer
- `id` string
- `imageContent` 'Face' | 'Portrait'
- `imageType` 'AnimatedGif' | 'Clipart' | 'Line' | 'Photo' | 'Shopping' | 'Transparent'
- `license` 'All' | 'Any' | 'Public' | 'Share' | 'ShareCommercially' | 'Modify' | 'ModifyCommercially'
- `mkt` string
- `maxFileSize` integer
- `maxHeight` integer
- `maxWidth` integer
- `minFileSize` integer
- `minHeight` integer
- `minWidth` integer
- `offset` integer
- `q` string, required
- `safeSearch` 'Off' | 'Moderate' | 'Strict'
- `size` 'All' | 'Small' | 'Medium' | 'Large' | 'Wallpaper'
- `setLang` string
- `width` integer

## Headers

- `X-BingApis-SDK` 'true', required
- `Accept` string
- `Accept-Language` string
- `User-Agent` string
- `X-MSEdge-ClientID` string
- `X-MSEdge-ClientIP` string
- `X-Search-Location` string

## Response `200`

Success.

- Images — Response base
  - `_type` string, required

## Other responses

- `default` — An error has occurred. Check the response type and/or status code for more details.

---

[API](https://skmtc.dev/azure/apis/custom-image-search-client.md) · [All operations](https://skmtc.dev/azure/apis/custom-image-search-client/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/custom-image-search-client/revisions/8c7b553f58a9/schema)