---
title: "Search Google video results"
method: GET
path: "/google/videos"
tags: ["Google"]
---

# Search Google video results

`GET /google/videos`

## Request

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

Returns Google video vertical results (title, platform, link, duration, age). Locale defaults to country=us and lang=en. Returns 503 when Google serves a challenge page or an unusable response.

## Query parameters

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

## Headers

- `x-api-key` string, required

## Response `200`

OK

- GoogleVideosResponseDoc
  - `code` integer
  - `data` GoogleVideosResponse
    - `pagination` GoogleVerticalPagination
      - `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` GoogleVideoResult[]: Video results in Google's order.
      - `age` string: When the video was published, as Google shows it.
      - `description` string: Video description snippet as shown on the Google results page.
      - `duration` string: Video length as Google shows it, for example `45:12`.
      - `platform` string: Platform hosting the video, for example `YouTube`.
      - `position` integer: Rank of the video across all pages for the query, starting at 1.
      - `thumbnail` string: URL of the video thumbnail.
      - `title` string: Video title as shown on the Google results page.
      - `url` string: URL of the video page.
  - `msg` string

## Other responses

- `400`: Missing or invalid query parameters
- `429`: Rate limit exceeded
- `500`: Internal server error
- `503`: Google 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/0497899e2016?raw)