---
title: "Search Google Videos"
method: GET
path: "/v1/google/videos/search"
tags: ["Google Videos"]
---

# Search Google Videos

`GET /v1/google/videos/search`

## Request

- Base URL: `https://scrapebadger.com`
- URL: `https://scrapebadger.com/v1/google/videos/search`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/scrapebadger/apis/scrapebadger-account-api/docs/v1/google/videos/search/get.ts> (a function with typed inputs; its response is checked against the schema)

Search Google for video results.

## Query parameters

- `q` string, required: Video search query
- `gl` string: Country code
- `hl` string: Language code
- `tbs` string, nullable: Time filter (e.g. qdr:d=past day, qdr:w=past week, qdr:m=past month)
- `safe` string: Safe search: off, active
- `page` integer: Page number (0-based, each page = 10 results)

## Response `200`

Successful Response

- VideosSearchResponse: Response for GET /api/v1/videos/search.
  - `results` VideoResult[]
    - `position` integer, nullable
    - `title` string, nullable
    - `link` string, nullable
    - `displayed_link` string, nullable
    - `thumbnail` string, nullable
    - `duration` string, nullable
    - `source` string, nullable
    - `date` string, nullable
  - `query` string, required
  - `language` string
  - `country` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/scrapebadger/apis/scrapebadger-account-api.md) - [All operations](https://skmtc.dev/scrapebadger/apis/scrapebadger-account-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scrapebadger/apis/scrapebadger-account-api/revisions/4a1ef8777baf?raw)