---
title: "Search YouTube videos"
method: GET
path: "/youtube/search"
tags: ["YouTube"]
---

# Search YouTube videos

`GET /youtube/search`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/youtube/search`
- Auth: API key in header `X-API-KEY`

## Query parameters

- `query` string, nullable
- `limit` integer, nullable
- `page` integer, nullable
- `continuation` string, nullable
- `hl` string, nullable
- `gl` string, nullable
- `type` 'video' | 'channel' | 'playlist' | 'movie' | 'all' | 'null', nullable
- `order` 'date' | 'rating' | 'relevance' | 'viewCount' | 'null', nullable
- `videoDuration` 'short' | 'medium' | 'long' | 'null', nullable
- `publishedAfter` string, date-time, nullable
- `publishedBefore` string, date-time, nullable
- `safeSearch` 'moderate' | 'none' | 'strict' | 'null', nullable

## Response `200`

- object
  - `results` object[], required
    - `type` string, required
    - `id` string, required
    - `title` string, required
    - `description` string, required
    - `thumbnail` string, nullable, required
    - `duration` string, required
    - `viewCount` string, required
    - `publishedTime` string, required
    - `channel` object, required
      - `id` string, required
      - `name` string, required
      - `thumbnail` string, nullable, required
      - `verified` boolean, required
      - `isVerifiedArtist` boolean, required
      - `url` string, required
    - `badges` string[], required
    - `isLive` boolean, required
    - `isShort` boolean, required
    - `isPremium` boolean, required
  - `pagination` object, required
    - `continuationToken` string, nullable, required
    - `hasMore` boolean, required
    - `page` integer, required
    - `pageSize` integer, required
  - `query` string, required
  - `filters` object, required
    - `type` string
    - `sort` string
    - `hl` string, nullable
    - `gl` string, nullable

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `422`: Validation error

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/1e1aa78ff103?raw)