# Custom Image Search Client API

> Custom Image Search Client API on Apizie: 1 endpoint (The Custom Image Search API lets you send an image search query to Bing and get image results found in your…) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://www.apizie.tech/v1/dev-tools:microsoft-cognitiveservices-custom-image-search/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `dev-tools:microsoft-cognitiveservices-custom-image-search`
- Category: Dev Tools
- Status: byok
- Source: https://microsoft.com
- Page: https://www.apizie.tech/api/dev-tools/microsoft-cognitiveservices-custom-image-search
- OpenAPI: https://www.apizie.tech/api/dev-tools/microsoft-cognitiveservices-custom-image-search/openapi.json

The Bing Custom Image Search API lets you send an image search query to Bing and get back image search results customized to meet your custom search definition.

## Endpoints

### The Custom Image Search API lets you send an image search query to Bing and get image results found in your…
`GET https://www.apizie.tech/v1/dev-tools:microsoft-cognitiveservices-custom-image-search/custom-instance-image-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-BingApis-SDK | string | yes | Activate swagger compliance |
| Accept-Language | string | no | A comma-delimited list of one or more languages to use for user interface strings. The list is in decreasing order of preference. For… |
| X-MSEdge-ClientID | string | no | Bing uses this header to provide users with consistent behavior across Bing API calls. Bing often flights new features and improvements,… |
| X-MSEdge-ClientIP | string | no | The IPv4 or IPv6 address of the client device. The IP address is used to discover the user's location. Bing uses the location information… |
| X-Search-Location | string | no | A semicolon-delimited list of key/value pairs that describe the client's geographical location. Bing uses the location information to… |
| customConfig | string | yes | The identifier for the custom search configuration |
| aspect | string | no | Filter images by the following aspect ratios. All: Do not filter by aspect.Specifying this value is the same as not specifying the aspect… |
| color | string | no | Filter images by the following color options. ColorOnly: Return color images. Monochrome: Return black and white images. Return images… |
| cc | string | no | A 2-character country code of the country where the results come from. For a list of possible values, see [Market… |
| count | integer | no | The number of images to return in the response. The actual number delivered may be less than requested. The default is 35. The maximum… |
| freshness | string | no | Filter images by the following discovery options. Day: Return images discovered by Bing within the last 24 hours. Week: Return images… |
| height | integer | no | Filter images that have the specified height, in pixels. You may use this filter with the size filter to return small images that have a… |
| id | string | no | An ID that uniquely identifies an image. Use this parameter to ensure that the specified image is the first image in the list of images… |
| imageContent | string | no | Filter images by the following content types. Face: Return images that show only a person's face. Portrait: Return images that show only a… |
| imageType | string | no | Filter images by the following image types. AnimatedGif: Return only animated GIFs. Clipart: Return only clip art images. Line: Return… |
| license | string | no | Filter images by the following license types. All: Do not filter by license type.Specifying this value is the same as not specifying the… |
| mkt | string | no | The market where the results come from. Typically, mkt is the country where the user is making the request from. However, it could be a… |
| maxFileSize | integer | no | Filter images that are less than or equal to the specified file size. The maximum file size that you may specify is 520,192 bytes. If you… |
| maxHeight | integer | no | Filter images that have a height that is less than or equal to the specified height. Specify the height in pixels. You may specify this… |
| maxWidth | integer | no | Filter images that have a width that is less than or equal to the specified width. Specify the width in pixels. You may specify this… |
| minFileSize | integer | no | Filter images that are greater than or equal to the specified file size. The maximum file size that you may specify is 520,192 bytes. If… |
| minHeight | integer | no | Filter images that have a height that is greater than or equal to the specified height. Specify the height in pixels. You may specify this… |
| minWidth | integer | no | Filter images that have a width that is greater than or equal to the specified width. Specify the width in pixels. You may specify this… |
| offset | integer | no | The zero-based offset that indicates the number of images to skip before returning images. The default is 0. The offset should be less… |
| q | string | yes | The user's search query term. The term cannot be empty. The term may contain [Bing Advanced… |
| safeSearch | string | no | Filter images for adult content. The following are the possible filter values. Off: May return images with adult content. If the request… |
| size | string | no | Filter images by the following sizes. All: Do not filter by size. Specifying this value is the same as not specifying the size parameter.… |
| setLang | string | no | The language to use for user interface strings. Specify the language using the ISO 639-1 2-letter language code. For example, the language… |
| width | integer | no | Filter images that have the specified width, in pixels. You may use this filter with the size filter to return small images that have a… |

## Example
```
curl "https://www.apizie.tech/v1/dev-tools:microsoft-cognitiveservices-custom-image-search/custom-instance-image-search" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Custom Image Search Client API?
Create a free Apizie key, then send GET https://www.apizie.tech/v1/dev-tools:microsoft-cognitiveservices-custom-image-search/custom-instance-image-search with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Custom Image Search Client API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Custom Image Search Client itself also needs your own key from microsoft.com.

### Can AI agents use the Custom Image Search Client API?
Yes. Add the Apizie MCP server (https://www.apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key dev-tools:microsoft-cognitiveservices-custom-image-search.

### What is the status of the Custom Image Search Client API?
Needs your own provider key (bring your own key)