---
title: "Scrape a YouTube channel's videos"
method: POST
path: "/content/youtube-channel"
tags: ["Plugins"]
---

# Scrape a YouTube channel's videos

`POST /content/youtube-channel`

## Request

- Base URL: `https://api.scrapeunblocker.com`
- URL: `https://api.scrapeunblocker.com/content/youtube-channel`
- Auth: API key in header `x-scrapeunblocker-key`

Returns a YouTube channel's recent videos as JSON: `videoId`, `title`, `views`, `published`, `thumbnail` and a watch `url`, plus a `channel` summary (name, id). Pass a handle (`@mkbhd`), a channel id (`UC...`) or a channel URL. Returns the channel's first page of videos (about 30).

## Query parameters

- `channel` string, required: Channel handle (@mkbhd), channel id (UC...) or a channel URL.
- `tab` string: Which tab: videos, shorts, streams.
- `proxy_country` string, nullable: Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE').
- `limit` integer: Max videos to return (1-200). Honoured on the 'videos' tab; other tabs return a single scraped page.

## Response `200`

JSON with a `channel` summary and a `videos` array.

- unknown

## Other responses

- `400`: Invalid parameters.
- `422`: Validation Error
- `502`: Blocked by YouTube, no channel page returned, or the call did not finish in time.

---

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