YouTube Playlists contains valuable data -- playlist entries from search, video results, channel results, shorts results, and more. Scraping this data directly means dealing with anti-bot detection, CAPTCHAs, IP rotation, and constantly breaking selectors. The Scavio API handles all of that and returns clean, structured JSON from a single POST request.
This tutorial shows you how to scrape YouTube Playlists using TypeScript and the Scavio API. By the end, you will have a working TypeScript script that fetches real-time YouTube Playlists data and parses the results.
Prerequisites
- TypeScript installed on your machine
- A Scavio API key (free tier includes 50 credits on signup -- no credit card required)
Step 1: Install Dependencies
Install fetch to make HTTP requests:
npm install -D typescript tsxStep 2: Make Your First YouTube Playlists Search
Send a POST request to the Scavio YouTube Playlists API endpoint with your query. The API returns structured JSON with playlist entries from search, video results, channel results, and more.
// Playlist data is not available: POST /api/v1/youtube/search accepts type: playlist but
// the provider returns an empty playlists array, so there is no playlist title, video
// count, creator or visibility to read, and no removal tracking. This sample returns the
// videos for the query; type: channel does work if you want creators instead.
const API_KEY = "sk_live_your_key";
const search = "best rag tutorials playlist";
interface YouTubePlaylistsResponse {
data: { results: Array<{ video_id: string; title: string; url: string; duration_text: string | null; view_count: number; published_time: string; channel: { id: string; name: string; url: string } }>; playlists: unknown[]; next_cursor: string | null };
response_time: number;
credits_used: number;
credits_remaining: number;
}
const response = await fetch("https://api.scavio.dev/api/v1/youtube/search", {
method: "POST",
headers: {
"Authorization": "Bearer " + API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({ search }),
});
if (!response.ok) {
throw new Error("Scavio API error: " + response.status);
}
const data = (await response.json()) as YouTubePlaylistsResponse;
const rows = data?.data?.results ?? [];
for (const row of rows.slice(0, 5)) {
console.log(row?.title);
console.log(" ", row?.channel?.name, row?.view_count, row?.url);
}Step 3: Example Response
The API returns structured JSON. Here is an example response for a YouTube Playlists search:
{
"data": {
"results": [
{
"video_id": "UyoVmQLekBc",
"title": "How I Built an AI Agent in 14 minutes as A Beginner (2026)",
"url": "https://www.youtube.com/watch?v=UyoVmQLekBc",
"duration_text": "18:02",
"view_count": 28950,
"published_time": "2 days ago",
"channel": { "id": "UCxxxxxxxx", "name": "Mikey No Code", "url": "https://www.youtube.com/channel/UCxxxxxxxx" }
}
],
"playlists": [],
"next_cursor": "EpcDEgtweXR..."
},
"response_time": 2380,
"credits_used": 2,
"credits_remaining": 4808
}Every field is structured and typed -- no HTML parsing, no CSS selectors, no regex extraction. Your TypeScript code can access any field directly.
Step 4: Full Working Example
Here is a complete, runnable TypeScript script that searches YouTube Playlists and prints the results:
/**
* Search YouTube Playlists data with the Scavio API.
* POST /api/v1/youtube/search - rows come back under data.results, 2 credits per call.
* Run with: npx tsx youtube-playlists.ts
*/
// Playlist data is not available: POST /api/v1/youtube/search accepts type: playlist but
// the provider returns an empty playlists array, so there is no playlist title, video
// count, creator or visibility to read, and no removal tracking. This sample returns the
// videos for the query; type: channel does work if you want creators instead.
const API_URL = "https://api.scavio.dev/api/v1/youtube/search";
const API_KEY = process.env.SCAVIO_API_KEY as string;
interface YouTubePlaylistsResponse {
data: { results: Array<{ video_id: string; title: string; url: string; duration_text: string | null; view_count: number; published_time: string; channel: { id: string; name: string; url: string } }>; playlists: unknown[]; next_cursor: string | null };
response_time: number;
credits_used: number;
credits_remaining: number;
}
async function searchYouTubePlaylists(search: string): Promise<YouTubePlaylistsResponse> {
const response = await fetch(API_URL, {
method: "POST",
headers: {
"Authorization": "Bearer " + API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({ search }),
});
if (!response.ok) {
throw new Error("Scavio API error: " + response.status);
}
return (await response.json()) as YouTubePlaylistsResponse;
}
const data = await searchYouTubePlaylists("best rag tutorials playlist");
const rows = data?.data?.results ?? [];
for (const row of rows.slice(0, 5)) {
console.log(row?.title);
console.log(" ", row?.channel?.name, row?.view_count, row?.url);
}Why Use Scavio Instead of Scraping YouTube Playlists Directly?
- No proxy management. Direct scraping requires rotating proxies to avoid IP bans. Scavio handles all of this server-side.
- No CAPTCHA solving. YouTube Playlists aggressively blocks automated requests. Scavio returns clean data every time.
- Structured JSON output. No HTML parsing or CSS selector maintenance. Get typed, consistent data from every request.
- Multi-platform in one API. Search Google, Amazon, YouTube, and Walmart from the same API key with the same authentication pattern.
- Free tier included. 50 credits on signup with no credit card required. Each search costs 1 credit.