---
title: "Search Bing video results"
method: GET
path: "/bing/videos"
tags: ["Bing"]
---

# Search Bing video results

`GET /bing/videos`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/bing/videos`
- Auth: API key in header `x-api-key`

Returns Bing video search results for a query string. Locale defaults to country=us and lang=en-us. Returns 503 when Bing serves a challenge page or unusable results.

## Query parameters

- `q` string, required
- `page` integer
- `count` integer
- `country` string
- `lang` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- BingVideosResponseDoc
  - `code` integer
  - `data` BingVideosResponse
    - `pagination` BingSearchPagination
      - `count` integer: Number of results requested per page.
      - `next_page` integer: Page number of the next page. Omitted when there is no next page.
      - `page` integer: Page number of this response, starting at 1.
      - `previous_page` integer: Page number of the previous page. Omitted on the first page.
    - `results` BingVideoResult[]: Video results in Bing's order.
      - `age` string: When the video was published, as Bing shows it.
      - `age_timestamp` integer: Time from `age` as Unix seconds in UTC. Omitted when it cannot be worked out.
      - `creator` string: Channel or creator that published the video.
      - `duration` string: Video length as Bing shows it, for example `45:12`.
      - `platform` string: Platform hosting the video, for example `YouTube`.
      - `position` integer: Rank of the video in the videos block, starting at 1.
      - `thumbnail` string: URL of the video thumbnail.
      - `title` string: Video title as shown on the Bing results page.
      - `url` string: URL of the video page.
      - `views` string: View count as Bing shows it, for example `1.2M views`.
  - `msg` string

## Other responses

- `400`: Missing or invalid query parameters
- `404`: No results found
- `429`: Rate limit exceeded
- `500`: Internal server error
- `503`: Bing upstream request failed

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)