Image Search APIs v7 reference
The Image Search APIs let you search for images that are relevant to the user's search query and also get trending videos. 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 Bing Image Search overview.
For information about permitted use and display of the results, see Use and display requirements.
Note
Because URL formats and parameters are subject to change without notice, use all URLs as-is. You should not take dependencies on the URL format or parameters except where noted.
Endpoints
To request image search results, send a GET request to one of the following endpoints:
| Endpoint | Description |
|---|---|
| https://api.bing.microsoft.com/v7.0/images/search | Returns images that are relevant to the user's search query. |
| https://api.bing.microsoft.com/v7.0/images/trending | Returns images that are trending based on search requests made by others. The images are broken out into different categories. For example, Popular People Searches. For a list of markets that support trending images, see Supported trending images markets. |
The request must use the HTTPS protocol.
Note
The maximum URL length is 2,048 characters. To ensure that your URL length does not exceed the limit, the maximum length of your query parameters should be less than 1,500 characters. If the URL exceeds 2,048 characters, the server returns 404 Not found.
Next steps
Check out the following programming elements you'll use when sending search requests: