Bing

Search Bing Videos

Search Bing Videos by keyword, market and time, with duration, views, publication date, publisher, channel and thumbnails.

GET/v1/bing/videos
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
5
querystringrequiredquery

What to search videos for, e.g. `marathon training plan`.

min 1 chars · max 500 chars

timestringoptionalquery

Only videos published in the past `day`, `week` or `month`. Default: any time.

one of: day, week, month

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page.

min 1 chars · max 4096 chars

countrystringoptionalquery

Two-letter country code of the results' market, e.g. `GB` or `DE`. Default: `US`.

pattern: ^[A-Z]{2}$

languagestringoptionalquery

Two-letter language code for a country with several, e.g. `fr` with `CH`. Default: the market's first language.

pattern: ^[a-z]{2}$

Response fields
26

Endpoint-specific response payload.

datalookupStatus
string

Always `found`: no match is an empty list.

one of: found, not_found

dataquery
string

The query that was searched.

datamarket
string

Bing's market the results are for, e.g. `en-US`.

Videos; about 90 a page, a few more on the first. A video already returned on an earlier page is left out.

datavideos[]id
string

Bing's id for the video.

datavideos[]title
string

Video title.

datavideos[]url
string

Video page URL.

datavideos[]duration
stringnullable

Length as shown, e.g. `12:04`.

datavideos[]viewCount
integernullable

Views where shown, rounded as Bing shows them.

datavideos[]publishedAt
stringnullable

Published, ISO 8601 UTC. Bing mostly shows an age (`2 weeks ago`), so this is the lookup's time less that age, as precise as the unit shown; null when Bing shows neither an age nor a date we can read.

datavideos[]publishedText
stringnullable

When it was published, as Bing shows it: `2 weeks ago` or `May 25, 2024`.

datavideos[]publisher
stringnullable

Site, e.g. `YouTube`.

datavideos[]uploader
stringnullable

Channel or account.

datavideos[]uploaderUrl
stringnullable

The channel's or account's page.

datavideos[]thumbnail
stringnullable

Thumbnail URL.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

datapagetruncated
boolean

True when the list stops here before Bing's own end: the deepest page we read, or a later page Bing kept answering empty.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/bing/videos?query=marathon%20training%20plan" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Bing video results for a query.