Find an API

Search public APIs with auth details & Postman guides

← All APIs

Image Search Client

microsoft · Developer Tools

Developer Tools No Auth Free & Open developer_tools cloud

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).

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET The Image Detail Search API lets you search on Bing and get back insights about an image, such as webpages that include the image. This section provides technical details about the query parameters and headers that you use to request insights of 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).

The Image Detail Search API lets you search on Bing and get back insights about an image, such as webpages that include the image. This section provides technical details about the query parameters and headers that you use to request insights of images and the JSON response objects that contain them

https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-ImageSearch/1.0/images/details?q=test&cc=example&ct=Rectangular&id=1&cab=1&cal=1&car=1&cat=1&mkt=example&imgUrl=example&modules=example&setLang=example&safeSearch=Off&insightsToken=example

Hover any highlighted part to learn what it does

Headers — extra info sent with the request
X-BingApis-SDK true 
curl -X GET "https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-ImageSearch/1.0/images/details?q=test&cc=example&ct=Rectangular&id=1&cab=1&cal=1&car=1&cat=1&mkt=example&imgUrl=example&modules=example&setLang=example&safeSearch=Off&insightsToken=example" \
  -H "X-BingApis-SDK: true"
import requests
params = {
    "q": "test",
    "cc": "example",
    "ct": "Rectangular",
    "id": "1",
    "cab": "1",
    "cal": "1",
    "car": "1",
    "cat": "1",
    "mkt": "example",
    "imgUrl": "example",
    "modules": "example",
    "setLang": "example",
    "safeSearch": "Off",
    "insightsToken": "example"
}
headers = {
    "X-BingApis-SDK": "true"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-ImageSearch/1.0/images/details",
    params=params,
    headers=headers,
)
print(response.json())
const url = new URL('https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-ImageSearch/1.0/images/details');
url.searchParams.set('q', 'test');
url.searchParams.set('cc', 'example');
url.searchParams.set('ct', 'Rectangular');
url.searchParams.set('id', '1');
url.searchParams.set('cab', '1');
url.searchParams.set('cal', '1');
url.searchParams.set('car', '1');
url.searchParams.set('cat', '1');
url.searchParams.set('mkt', 'example');
url.searchParams.set('imgUrl', 'example');
url.searchParams.set('modules', 'example');
url.searchParams.set('setLang', 'example');
url.searchParams.set('safeSearch', 'Off');
url.searchParams.set('insightsToken', 'example');

const response = await fetch(url, {
  headers: {
    'X-BingApis-SDK': 'true'
  },
}); 
const data = await response.json();
console.log(data);
package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-ImageSearch/1.0/images/details")
	q := baseURL.Query()
	q.Set("q", "test")
	q.Set("cc", "example")
	q.Set("ct", "Rectangular")
	q.Set("id", "1")
	q.Set("cab", "1")
	q.Set("cal", "1")
	q.Set("car", "1")
	q.Set("cat", "1")
	q.Set("mkt", "example")
	q.Set("imgUrl", "example")
	q.Set("modules", "example")
	q.Set("setLang", "example")
	q.Set("safeSearch", "Off")
	q.Set("insightsToken", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)
	req.Header.Set("X-BingApis-SDK", "true")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}
require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-ImageSearch/1.0/images/details")
uri.query = URI.encode_www_form({
  "q" => "test",
  "cc" => "example",
  "ct" => "Rectangular",
  "id" => "1",
  "cab" => "1",
  "cal" => "1",
  "car" => "1",
  "cat" => "1",
  "mkt" => "example",
  "imgUrl" => "example",
  "modules" => "example",
  "setLang" => "example",
  "safeSearch" => "Off",
  "insightsToken" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)
req["X-BingApis-SDK"] = "true"

res = http.request(req)
puts JSON.parse(res.body)
<?php
$url = "https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-ImageSearch/1.0/images/details?" . http_build_query([
    "q" => "test",
    "cc" => "example",
    "ct" => "Rectangular",
    "id" => "1",
    "cab" => "1",
    "cal" => "1",
    "car" => "1",
    "cat" => "1",
    "mkt" => "example",
    "imgUrl" => "example",
    "modules" => "example",
    "setLang" => "example",
    "safeSearch" => "Off",
    "insightsToken" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
    "header" => implode("\r\n", [
        "X-BingApis-SDK: true"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));
GET 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).

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

https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-ImageSearch/1.0/images/search?q=test&cc=example&id=1&mkt=example&size=All&color=ColorOnly&count=10&width=1&aspect=All&height=1&offset=0&license=All&setLang=example&maxWidth=1&minWidth=1&freshness=Day&imageType=AnimatedGif&maxHeight=1&minHeight=1&safeSearch=Off&maxFileSize=1&minFileSize=1&imageContent=Face

Hover any highlighted part to learn what it does

Headers — extra info sent with the request
X-BingApis-SDK true 
curl -X GET "https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-ImageSearch/1.0/images/search?q=test&cc=example&id=1&mkt=example&size=All&color=ColorOnly&count=10&width=1&aspect=All&height=1&offset=0&license=All&setLang=example&maxWidth=1&minWidth=1&freshness=Day&imageType=AnimatedGif&maxHeight=1&minHeight=1&safeSearch=Off&maxFileSize=1&minFileSize=1&imageContent=Face" \
  -H "X-BingApis-SDK: true"
import requests
params = {
    "q": "test",
    "cc": "example",
    "id": "1",
    "mkt": "example",
    "size": "All",
    "color": "ColorOnly",
    "count": "10",
    "width": "1",
    "aspect": "All",
    "height": "1",
    "offset": "0",
    "license": "All",
    "setLang": "example",
    "maxWidth": "1",
    "minWidth": "1",
    "freshness": "Day",
    "imageType": "AnimatedGif",
    "maxHeight": "1",
    "minHeight": "1",
    "safeSearch": "Off",
    "maxFileSize": "1",
    "minFileSize": "1",
    "imageContent": "Face"
}
headers = {
    "X-BingApis-SDK": "true"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-ImageSearch/1.0/images/search",
    params=params,
    headers=headers,
)
print(response.json())
const url = new URL('https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-ImageSearch/1.0/images/search');
url.searchParams.set('q', 'test');
url.searchParams.set('cc', 'example');
url.searchParams.set('id', '1');
url.searchParams.set('mkt', 'example');
url.searchParams.set('size', 'All');
url.searchParams.set('color', 'ColorOnly');
url.searchParams.set('count', '10');
url.searchParams.set('width', '1');
url.searchParams.set('aspect', 'All');
url.searchParams.set('height', '1');
url.searchParams.set('offset', '0');
url.searchParams.set('license', 'All');
url.searchParams.set('setLang', 'example');
url.searchParams.set('maxWidth', '1');
url.searchParams.set('minWidth', '1');
url.searchParams.set('freshness', 'Day');
url.searchParams.set('imageType', 'AnimatedGif');
url.searchParams.set('maxHeight', '1');
url.searchParams.set('minHeight', '1');
url.searchParams.set('safeSearch', 'Off');
url.searchParams.set('maxFileSize', '1');
url.searchParams.set('minFileSize', '1');
url.searchParams.set('imageContent', 'Face');

const response = await fetch(url, {
  headers: {
    'X-BingApis-SDK': 'true'
  },
}); 
const data = await response.json();
console.log(data);
package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-ImageSearch/1.0/images/search")
	q := baseURL.Query()
	q.Set("q", "test")
	q.Set("cc", "example")
	q.Set("id", "1")
	q.Set("mkt", "example")
	q.Set("size", "All")
	q.Set("color", "ColorOnly")
	q.Set("count", "10")
	q.Set("width", "1")
	q.Set("aspect", "All")
	q.Set("height", "1")
	q.Set("offset", "0")
	q.Set("license", "All")
	q.Set("setLang", "example")
	q.Set("maxWidth", "1")
	q.Set("minWidth", "1")
	q.Set("freshness", "Day")
	q.Set("imageType", "AnimatedGif")
	q.Set("maxHeight", "1")
	q.Set("minHeight", "1")
	q.Set("safeSearch", "Off")
	q.Set("maxFileSize", "1")
	q.Set("minFileSize", "1")
	q.Set("imageContent", "Face")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)
	req.Header.Set("X-BingApis-SDK", "true")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}
require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-ImageSearch/1.0/images/search")
uri.query = URI.encode_www_form({
  "q" => "test",
  "cc" => "example",
  "id" => "1",
  "mkt" => "example",
  "size" => "All",
  "color" => "ColorOnly",
  "count" => "10",
  "width" => "1",
  "aspect" => "All",
  "height" => "1",
  "offset" => "0",
  "license" => "All",
  "setLang" => "example",
  "maxWidth" => "1",
  "minWidth" => "1",
  "freshness" => "Day",
  "imageType" => "AnimatedGif",
  "maxHeight" => "1",
  "minHeight" => "1",
  "safeSearch" => "Off",
  "maxFileSize" => "1",
  "minFileSize" => "1",
  "imageContent" => "Face"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)
req["X-BingApis-SDK"] = "true"

res = http.request(req)
puts JSON.parse(res.body)
<?php
$url = "https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-ImageSearch/1.0/images/search?" . http_build_query([
    "q" => "test",
    "cc" => "example",
    "id" => "1",
    "mkt" => "example",
    "size" => "All",
    "color" => "ColorOnly",
    "count" => "10",
    "width" => "1",
    "aspect" => "All",
    "height" => "1",
    "offset" => "0",
    "license" => "All",
    "setLang" => "example",
    "maxWidth" => "1",
    "minWidth" => "1",
    "freshness" => "Day",
    "imageType" => "AnimatedGif",
    "maxHeight" => "1",
    "minHeight" => "1",
    "safeSearch" => "Off",
    "maxFileSize" => "1",
    "minFileSize" => "1",
    "imageContent" => "Face"
]);
$opts = ["http" => [
    "method" => "GET",
    "header" => implode("\r\n", [
        "X-BingApis-SDK: true"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));
GET The Image Trending Search API lets you search on Bing and get back a list of 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 [Trending Images](https://docs.microsoft.com/en-us/azure/cognitive-services/bing-image-search/trending-images).

The Image Trending Search API lets you search on Bing and get back a list of 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 [Trending

https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-ImageSearch/1.0/images/trending?cc=example&mkt=example&setLang=example&safeSearch=Off

Hover any highlighted part to learn what it does

Headers — extra info sent with the request
X-BingApis-SDK true 
curl -X GET "https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-ImageSearch/1.0/images/trending?cc=example&mkt=example&setLang=example&safeSearch=Off" \
  -H "X-BingApis-SDK: true"
import requests
params = {
    "cc": "example",
    "mkt": "example",
    "setLang": "example",
    "safeSearch": "Off"
}
headers = {
    "X-BingApis-SDK": "true"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-ImageSearch/1.0/images/trending",
    params=params,
    headers=headers,
)
print(response.json())
const url = new URL('https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-ImageSearch/1.0/images/trending');
url.searchParams.set('cc', 'example');
url.searchParams.set('mkt', 'example');
url.searchParams.set('setLang', 'example');
url.searchParams.set('safeSearch', 'Off');

const response = await fetch(url, {
  headers: {
    'X-BingApis-SDK': 'true'
  },
}); 
const data = await response.json();
console.log(data);
package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-ImageSearch/1.0/images/trending")
	q := baseURL.Query()
	q.Set("cc", "example")
	q.Set("mkt", "example")
	q.Set("setLang", "example")
	q.Set("safeSearch", "Off")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)
	req.Header.Set("X-BingApis-SDK", "true")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}
require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-ImageSearch/1.0/images/trending")
uri.query = URI.encode_www_form({
  "cc" => "example",
  "mkt" => "example",
  "setLang" => "example",
  "safeSearch" => "Off"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)
req["X-BingApis-SDK"] = "true"

res = http.request(req)
puts JSON.parse(res.body)
<?php
$url = "https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-ImageSearch/1.0/images/trending?" . http_build_query([
    "cc" => "example",
    "mkt" => "example",
    "setLang" => "example",
    "safeSearch" => "Off"
]);
$opts = ["http" => [
    "method" => "GET",
    "header" => implode("\r\n", [
        "X-BingApis-SDK: true"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗
  1. See official documentation for authentication and setup.

What can you build with Image Search Client?

Image Search Client is a Developer Tools API. Developers commonly use developer tools APIs for:

  • automating code review and quality checks
  • integrating CI/CD pipelines and build systems
  • managing feature flags and A/B tests
  • monitoring errors and application performance
  • generating and validating test data

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Image Search Client is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗