Video Search Client
microsoft · Developer Tools
The Video Search API lets you search on Bing for video that are relevant to the user's search query, for insights about a video or for videos that are trending based on search requests made by others. This section provides technical details about the query parameters and headers that you use to request videos and the JSON response objects that contain them. For examples that show how to make requests, see [Searching the Web for Videos](https://docs.microsoft.com/azure/cognitive-services/bing-vid
Authentication
Sample Requests
The Video Detail Search API lets you search on Bing and get back insights about a video, such as related videos. This section provides technical details about the query parameters and headers that you use to request insights of videos and the JSON response objects that contain them. For examples tha
Hover any highlighted part to learn what it does
| X-BingApis-SDK | true |
curl -X GET "https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-VideoSearch/1.0/videos/details?q=test&cc=example&id=1&mkt=example&modules=example&setLang=example&resolution=All&safeSearch=Off&textFormat=Raw&textDecorations=true" \ -H "X-BingApis-SDK: true"
import requests
params = {
"q": "test",
"cc": "example",
"id": "1",
"mkt": "example",
"modules": "example",
"setLang": "example",
"resolution": "All",
"safeSearch": "Off",
"textFormat": "Raw",
"textDecorations": "true"
}
headers = {
"X-BingApis-SDK": "true"
}
response = requests.get(
"https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-VideoSearch/1.0/videos/details",
params=params,
headers=headers,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-VideoSearch/1.0/videos/details');
url.searchParams.set('q', 'test');
url.searchParams.set('cc', 'example');
url.searchParams.set('id', '1');
url.searchParams.set('mkt', 'example');
url.searchParams.set('modules', 'example');
url.searchParams.set('setLang', 'example');
url.searchParams.set('resolution', 'All');
url.searchParams.set('safeSearch', 'Off');
url.searchParams.set('textFormat', 'Raw');
url.searchParams.set('textDecorations', 'true');
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-VideoSearch/1.0/videos/details")
q := baseURL.Query()
q.Set("q", "test")
q.Set("cc", "example")
q.Set("id", "1")
q.Set("mkt", "example")
q.Set("modules", "example")
q.Set("setLang", "example")
q.Set("resolution", "All")
q.Set("safeSearch", "Off")
q.Set("textFormat", "Raw")
q.Set("textDecorations", "true")
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-VideoSearch/1.0/videos/details")
uri.query = URI.encode_www_form({
"q" => "test",
"cc" => "example",
"id" => "1",
"mkt" => "example",
"modules" => "example",
"setLang" => "example",
"resolution" => "All",
"safeSearch" => "Off",
"textFormat" => "Raw",
"textDecorations" => "true"
})
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-VideoSearch/1.0/videos/details?" . http_build_query([
"q" => "test",
"cc" => "example",
"id" => "1",
"mkt" => "example",
"modules" => "example",
"setLang" => "example",
"resolution" => "All",
"safeSearch" => "Off",
"textFormat" => "Raw",
"textDecorations" => "true"
]);
$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));The Video Search API lets you send a search query to Bing and get back a list of videos that are relevant to the search query. This section provides technical details about the query parameters and headers that you use to request videos and the JSON response objects that contain them. For examples t
Hover any highlighted part to learn what it does
| X-BingApis-SDK | true |
curl -X GET "https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-VideoSearch/1.0/videos/search?q=test&cc=example&id=1&mkt=example&count=10&length=All&offset=0&pricing=All&setLang=example&freshness=Day&resolution=All&safeSearch=Off&textFormat=Raw&textDecorations=true" \ -H "X-BingApis-SDK: true"
import requests
params = {
"q": "test",
"cc": "example",
"id": "1",
"mkt": "example",
"count": "10",
"length": "All",
"offset": "0",
"pricing": "All",
"setLang": "example",
"freshness": "Day",
"resolution": "All",
"safeSearch": "Off",
"textFormat": "Raw",
"textDecorations": "true"
}
headers = {
"X-BingApis-SDK": "true"
}
response = requests.get(
"https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-VideoSearch/1.0/videos/search",
params=params,
headers=headers,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-VideoSearch/1.0/videos/search');
url.searchParams.set('q', 'test');
url.searchParams.set('cc', 'example');
url.searchParams.set('id', '1');
url.searchParams.set('mkt', 'example');
url.searchParams.set('count', '10');
url.searchParams.set('length', 'All');
url.searchParams.set('offset', '0');
url.searchParams.set('pricing', 'All');
url.searchParams.set('setLang', 'example');
url.searchParams.set('freshness', 'Day');
url.searchParams.set('resolution', 'All');
url.searchParams.set('safeSearch', 'Off');
url.searchParams.set('textFormat', 'Raw');
url.searchParams.set('textDecorations', 'true');
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-VideoSearch/1.0/videos/search")
q := baseURL.Query()
q.Set("q", "test")
q.Set("cc", "example")
q.Set("id", "1")
q.Set("mkt", "example")
q.Set("count", "10")
q.Set("length", "All")
q.Set("offset", "0")
q.Set("pricing", "All")
q.Set("setLang", "example")
q.Set("freshness", "Day")
q.Set("resolution", "All")
q.Set("safeSearch", "Off")
q.Set("textFormat", "Raw")
q.Set("textDecorations", "true")
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-VideoSearch/1.0/videos/search")
uri.query = URI.encode_www_form({
"q" => "test",
"cc" => "example",
"id" => "1",
"mkt" => "example",
"count" => "10",
"length" => "All",
"offset" => "0",
"pricing" => "All",
"setLang" => "example",
"freshness" => "Day",
"resolution" => "All",
"safeSearch" => "Off",
"textFormat" => "Raw",
"textDecorations" => "true"
})
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-VideoSearch/1.0/videos/search?" . http_build_query([
"q" => "test",
"cc" => "example",
"id" => "1",
"mkt" => "example",
"count" => "10",
"length" => "All",
"offset" => "0",
"pricing" => "All",
"setLang" => "example",
"freshness" => "Day",
"resolution" => "All",
"safeSearch" => "Off",
"textFormat" => "Raw",
"textDecorations" => "true"
]);
$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));The Video Trending Search API lets you search on Bing and get back a list of videos that are trending based on search requests made by others. The videos are broken out into different categories. For example, Top Music Videos. For a list of markets that support trending videos, see [Trending Videos]
Hover any highlighted part to learn what it does
| X-BingApis-SDK | true |
curl -X GET "https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-VideoSearch/1.0/videos/trending?cc=example&mkt=example&setLang=example&safeSearch=Off&textFormat=Raw&textDecorations=true" \ -H "X-BingApis-SDK: true"
import requests
params = {
"cc": "example",
"mkt": "example",
"setLang": "example",
"safeSearch": "Off",
"textFormat": "Raw",
"textDecorations": "true"
}
headers = {
"X-BingApis-SDK": "true"
}
response = requests.get(
"https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-VideoSearch/1.0/videos/trending",
params=params,
headers=headers,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/microsoft.com/cognitiveservices-VideoSearch/1.0/videos/trending');
url.searchParams.set('cc', 'example');
url.searchParams.set('mkt', 'example');
url.searchParams.set('setLang', 'example');
url.searchParams.set('safeSearch', 'Off');
url.searchParams.set('textFormat', 'Raw');
url.searchParams.set('textDecorations', 'true');
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-VideoSearch/1.0/videos/trending")
q := baseURL.Query()
q.Set("cc", "example")
q.Set("mkt", "example")
q.Set("setLang", "example")
q.Set("safeSearch", "Off")
q.Set("textFormat", "Raw")
q.Set("textDecorations", "true")
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-VideoSearch/1.0/videos/trending")
uri.query = URI.encode_www_form({
"cc" => "example",
"mkt" => "example",
"setLang" => "example",
"safeSearch" => "Off",
"textFormat" => "Raw",
"textDecorations" => "true"
})
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-VideoSearch/1.0/videos/trending?" . http_build_query([
"cc" => "example",
"mkt" => "example",
"setLang" => "example",
"safeSearch" => "Off",
"textFormat" => "Raw",
"textDecorations" => "true"
]);
$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
- See official documentation for authentication and setup.
What can you build with Video Search Client?
Video 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. Video 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?