---
title: "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 that show how to make requests, see [Searching the Web for Videos](https://docs.microsoft.com/azure/cognitive-services/bing-video-search/search-the-web)."
method: GET
path: "/videos/search"
tags: ["VideoSearch"]
---

# 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 that show how to make requests, see [Searching the Web for Videos](https://docs.microsoft.com/azure/cognitive-services/bing-video-search/search-the-web).

`GET /videos/search`

## Query parameters

- `cc` string
- `count` integer
- `freshness` 'Day' | 'Week' | 'Month'
- `id` string
- `length` 'All' | 'Short' | 'Medium' | 'Long'
- `mkt` string
- `offset` integer
- `pricing` 'All' | 'Free' | 'Paid'
- `q` string, required
- `resolution` 'All' | 'SD480p' | 'HD720p' | 'HD1080p'
- `safeSearch` 'Off' | 'Moderate' | 'Strict'
- `setLang` string
- `textDecorations` boolean
- `textFormat` 'Raw' | 'Html'

## Headers

- `X-BingApis-SDK` 'true', required
- `Accept` string
- `Accept-Language` string
- `User-Agent` string
- `X-MSEdge-ClientID` string
- `X-MSEdge-ClientIP` string
- `X-Search-Location` string

## Response `200`

Success.

- Videos
  - `_type` string, required

## Other responses

- `default` — An error has occurred. Check the response type and/or status code for more details.

---

[API](https://skmtc.net/azure/apis/video-search-client.md) · [All operations](https://skmtc.net/azure/apis/video-search-client/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/video-search-client/revisions/48f95b23910e/schema)