JustSERPDocs
Bing

Bing Videos

One page of Bing Videos results (50 on the first page, 35 on later ones), answered as the document: `search_metadata`, `search_parameters`, `search_information` (`query_displayed`), `videos`, `shorts` (the portrait videos) and `pagination`.

GET
/v1/bing/videos

One page of Bing Videos results (50 on the first page, 35 on later ones), answered as the document: search_metadata, search_parameters, search_information (query_displayed), videos, shorts (the portrait videos) and pagination. Filters: duration, age, quality, site and price. No snippet, is_paid, suggestions, related searches or ads. zero_retention is not handled.

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

cancel_token?string

A name you make up for this request (a UUID is fine), so you can later GET /v1/cancel with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.

Length1 <= length <= 128
q*string

What to search for.

Lengthlength <= 1000
device?"desktop"

Anything but desktop is a 400.

Default"desktop"
Value in"desktop"
market_code?string

language-country from Bing's list (en-us...). Not with country_code.

country_code?string

Two letters from Bing's list.

Default"US"
language?string

Bing's list.

Default"en"
duration?string

Under 5 minutes, 5-20, over 20.

Value in"short""medium""long"
time_period?string
Value in"last_day""last_week""last_month""last_year"
quality?string
Value in"lower_than_360p""360p_or_higher""480p_or_higher""720p_or_higher""1080p_or_higher"
source?string
Value in"dailymotion""vimeo""metacafe""hulu""vevo""myspace""mtv""cbs""fox""cnn""msn"
price?string
Value in"free""paid"
page?integer

The first page holds 50 videos, later ones 35.

Range1 <= value <= 100
Default1

Response Body

The videos, as the document. When the page could not be parsed, the usual envelope.

application/json
  1. response

The Bing Videos document.

search_metadata*
search_parameters*

The request's own fields as sent, engine first, without cancel_token.

search_information*

The parser's own, e.g. yelp_search's; otherwise {}.

videos?array<>
shorts?array<>

The videos whose thumbnail is taller than wide.

pagination?
[key: string]?any
Example Request
curl -X GET 'https://api.justserp.com/v1/bing/videos?q=golden+retriever&duration=short&time_period=last_week'
Example Response
{  "search_metadata": {    "id": "string",    "status": "Success",    "created_at": "string",    "request_url": "string",    "html_url": "string"  },  "search_parameters": {},  "search_information": {    "query_displayed": "string",    "safe_search": "string"  },  "videos": [    {      "position": 0,      "title": "string",      "link": "string",      "length": "string",      "source": "string",      "date": "string",      "channel": "string",      "views": 0,      "thumbnail": "string"    }  ],  "shorts": [    {      "position": 0,      "title": "string",      "link": "string",      "length": "string",      "source": "string",      "date": "string",      "channel": "string",      "views": 0,      "thumbnail": "string"    }  ],  "pagination": {    "current": 0,    "previous": "string",    "next": "string"  }}

Bing Images GET

One page of Bing Images results (35 pictures), answered as the document: `search_metadata`, `search_parameters`, `search_information` (`query_displayed`), `suggestions`, `images` and `related_searches`.

Bing Shopping GET

One page of Bing Shopping listings (36 products), answered as the document: `search_metadata`, `search_parameters`, `search_information` (`query_displayed`, `total_results`, `filters_applied`, `page`), `filters`, `shopping_ads` (the sponsored carousels), `shopping_results` (each with a `product_token` for `bing_product`), `suggestions` and `pagination`.