Custom Image Search Client API

by microsoft.com

Overview

The Bing Custom Image Search API lets you send an image search query to Bing and get back image search results customized to meet your custom search definition.

Custom Image Search Client is a development API from microsoft.com. Requests are authenticated with an API key. It is served over HTTPS. Its OpenAPI description documents 1 endpoints.

At a glance

Authentication: API key
HTTPS: Yes
CORS: Unknown
Category: Development
Base URL: https://api.cognitive.microsoft.com/bingcustomsearch/v7.0
Version: 1.0
Endpoints: 1
OpenAPI: Specification ↗
Spec updated: 2020-07-22

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL

curl -X GET "https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/images/search" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript

const response = await fetch("https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/images/search", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
  },
});
const data = await response.json();
console.log(data);

Python

import requests

response = requests.request(
    "GET",
    "https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/images/search",
    headers={
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
    },
    timeout=30,
)
print(response.json())

Endpoints

Method	Path	What it does
GET	`/images/search`	The Custom Image Search API lets you send an image search query to Bing and get image results found in your custom view of the web.