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

# Search

`GET /v1/youtube/search`

Searches YouTube by keyword query and returns matching videos, channels, playlists, shorts, shelves, and live streams. Each video result includes title, URL, thumbnail, view count (views), publish date, duration, channel info, and badges. Supports filtering by upload date, sorting by relevance or popularity, and paginating with continuationToken. Set is_paid_promotions=true to search YouTube videos with the paid product placement / sponsorship disclosure.

## Query parameters

- `query` string, required
- `uploadDate` 'today' | 'this_week' | 'this_month' | 'this_year'
- `sortBy` 'relevance' | 'popular'
- `type` 'videos' | 'shorts' | 'channels' | 'playlists'
- `duration` 'under_3_min' | 'between_3_and_20_min' | 'over_20_min'
- `region` string
- `continuationToken` string
- `includeExtras` string

## Response `200`

Successful response

---

[API](https://skmtc.dev/scrapecreators/apis/scrape-creators-api.md) · [All operations](https://skmtc.dev/scrapecreators/apis/scrape-creators-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scrapecreators/scrape-creators-api/revisions/e9ec3dbbd8b8/schema)