Endpoints for the Bing Image Search API
Bing Search APIs are moving from Cognitive Services to Bing Search Services. Starting October 30, 2020, any new instances of Bing Search need to be provisioned following the process documented here. Bing Search APIs provisioned using Cognitive Services will be supported for the next three years or until the end of your Enterprise Agreement, whichever happens first. For migration instructions, see Bing Search Services.
The Image Search API includes three endpoints. Endpoint 1 returns images from the Web based on a query. Endpoint 2 returns ImageInsights. Endpoint 3 returns trending images.
To get image results using the Bing API, send a request to one of the following endpoints. Use the headers and URL parameters to define further specifications.
Endpoint 1: Returns images that are relevant to the user's search query defined by
Endpoint 2: Returns insights about an image, using either
GET or POST https://api.cognitive.microsoft.com/bing/v7.0/images/details
A GET request returns insights about an image, such as Web pages that include the image. Include the insightsToken parameter with a
Or, you can include a binary image in the body of a
POST request and set the modules parameter to
RecognizedEntities. This will return an insightsToken to use as a parameter in a subsequent
GET request, which returns information about people in the image. Set
All to get all insights, except
RecognizedEntities in the results of the
POST without making another call using the
Endpoint 3: Returns images that are trending based on search requests made by others. The images are separated into different categories, for example, based on noteworthy people or events.
For a list of markets that support trending images, see Trending Images.
For details about headers, parameters, market codes, response objects, errors, etc., see the Bing Image Search API v7 reference.
The Bing APIs support search actions that return results according to their type. All search endpoints return results as JSON response objects. All endpoints support queries that return a specific language and/or location by longitude, latitude, and search radius.
For complete information about the parameters supported by each endpoint, see the reference pages for each type. For examples of basic requests using the Image search API, see Image Search Quick-starts.