# Image Search Client API

> Image Search Client API on Apizie: 3 endpoints (The Image Detail Search API lets you search on Bing and get back insights about an image, such as webpages…, The Image Search API lets you send a search query to Bing and get back a list of relevant images. This…, The Image Trending Search API lets you search on Bing and get back a list of images that are trending based…) 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://apizie.tech/v1/dev-tools:microsoft-cognitiveservices-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-image-search`
- Category: Dev Tools
- Status: byok
- Source: https://microsoft.com
- Page: https://apizie.tech/api/dev-tools/microsoft-cognitiveservices-image-search
- OpenAPI: https://apizie.tech/api/dev-tools/microsoft-cognitiveservices-image-search/openapi.json

The Image Search API lets you send a search query to Bing and get back a list of relevant images. This section provides technical details about the query parameters and headers that you use to request images and the…

## Endpoints

### The Image Detail Search API lets you search on Bing and get back insights about an image, such as webpages…
`GET https://apizie.tech/v1/dev-tools:microsoft-cognitiveservices-image-search/images-details` (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… |
| cab | number | no | The bottom coordinate of the region to crop. The coordinate is a fractional value of the original image's height and is measured from the… |
| cal | number | no | The left coordinate of the region to crop. The coordinate is a fractional value of the original image's height and is measured from the… |
| car | number | no | The right coordinate of the region to crop. The coordinate is a fractional value of the original image's height and is measured from the… |
| cat | number | no | The top coordinate of the region to crop. The coordinate is a fractional value of the original image's height and is measured from the… |
| ct | string | no | The crop type to use when cropping the image based on the coordinates specified in the cal, cat, car, and cab parameters. The following… |
| cc | string | no | A 2-character country code of the country where the results come from. For a list of possible values, see [Market… |
| 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… |
| imgUrl | string | no | The URL of an image that you want to get insights of. Use this parameter as an alternative to using the insightsToken parameter to specify… |
| insightsToken | string | no | An image token. The [Image](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#image) object's… |
| modules | array | no | A comma-delimited list of insights to request. The following are the possible case-insensitive values. All: Return all insights, if… |
| 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… |
| 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… |
| 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… |

### The Image Search API lets you send a search query to Bing and get back a list of relevant images. This…
`GET https://apizie.tech/v1/dev-tools:microsoft-cognitiveservices-image-search/images-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… |
| 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… |

### The Image Trending Search API lets you search on Bing and get back a list of images that are trending based…
`GET https://apizie.tech/v1/dev-tools:microsoft-cognitiveservices-image-search/images-trending` (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… |
| cc | string | no | A 2-character country code of the country where the results come from. This API supports only the United States, Canada, Australia, and… |
| 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… |
| 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… |
| 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… |

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

## FAQ

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

### Is the 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. Image Search Client itself also needs your own key from microsoft.com.

### Can AI agents use the Image Search Client API?
Yes. Add the Apizie MCP server (https://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-image-search.

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