---
title: "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 JSON response objects that contain them. For examples that show how to make requests, see [Searching the Web for Images](https://docs.microsoft.com/azure/cognitive-services/bing-image-search/search-the-web)."
method: GET
path: "/images/search"
tags: ["ImageSearch"]
---

# 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 JSON response objects that contain them. For examples that show how to make requests, see \[Searching the Web for Images\](https://docs.microsoft.com/azure/cognitive-services/bing-image-search/search-the-web).

`GET /images/search`

## Query parameters

- `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/image-search-client.md) · [All operations](https://skmtc.dev/azure/apis/image-search-client/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/image-search-client/revisions/2dc16bdef49d/schema)