Bing Videos API documentation for developers who need Bing video search as JSON. Scrappa's GET /api/bing/videos endpoint returns video links with thumbnail, duration, channel, platform, view count and upload date.
How to call the endpoint
Send a GET request with a required query and your API key in the x-api-key header. Page with page (1-6, about 35 videos per page; pages can repeat a few videos, so de-duplicate by id when you merge pages). Narrow by upload age with freshness: day, week or month. Use mkt, cc and setlang for another market.
Response fields
Each video has position, id, title, url, thumbnail, duration, channel, platform, views, posted (Bing's text in the language of the market) and posted_at (approximate ISO time). With freshness, videos that are provably older are removed. Bing does not return video descriptions in this view.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
6 optional filters available.
string
Required
Video search query.
Example: cats
coffee shops
string
Optional
Alias for query. Prefer query for new integrations.
coffee shops
string
Optional
Page number, about 35 videos per page. Bing has no videos beyond about page 6.
Range: 1-6
Default: 1
1
string
Optional
Only videos up to this age: day, week or month.
example
string
Optional
Bing market, language and region together, for example de-DE or en-GB. Results, wording and dates follow the market.
Default: en-US
example
string
Optional
Two-letter country code, for example DE. Scrappa sends it together with mkt.
Default: the country of mkt
example
string
Optional
Interface language, for example de. Scrappa sends it together with mkt.
Default: the language of mkt
example
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
page
query
market
source
freshness
results_on_page
Common data fields
id
url
title
views
{
"data": [
{
"id": "C189B1417D5CC7873D09C189B1417D5CC7873D09",
"url": "https://www.youtube.com/watch?v=sppNnsF0gUk",
"title": "You Can\u2019t Stop Laughing At These Cats TOP Funny Cats Video 2025",
"views": "3.8M views",
"posted": "10 months ago",
"channel": "Funny And Cute Cat's Life",
"duration": "29:40",
"platform": "YouTube",
"position": 1,
"posted_at": "2025-12-31T00:00:00Z",
"thumbnail": "https://ts3.mm.bing.net/th?id=OVP.FnWWA52PJELHXQCWXdM7HwEsDh&pid=15.1&W=160&H=120"
}
],
"page": 1,
"query": "cats",
"market": {
"cc": "US",
"mkt": "en-US",
"setlang": "en"
},
"source": "bing",
"freshness": null,
"results_on_page": 1
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
The query is missing, or page, freshness, mkt, cc or setlang failed validation.
{
"errors": {
"query": [
"The query field is required."
]
},
"message": "The request validation failed"
}Bing Temporarily Unavailable
Bing did not return usable data after the bounded retry on a second route. The request is not billed. Retry shortly.
{
"error": "Bing upstream is temporarily unavailable. Please retry shortly.",
"service": "BingVerticalsService",
"retryable": true,
"error_code": "bing_upstream_unavailable",
"failed_stage": "upstream_request"
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.