Playlist videos
curl --request GET \
--url https://api.scraperize.com/v1/youtube/playlist \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/youtube/playlist"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.scraperize.com/v1/youtube/playlist', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.scraperize.com/v1/youtube/playlist",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.scraperize.com/v1/youtube/playlist"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.scraperize.com/v1/youtube/playlist")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/youtube/playlist")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"playlist": {
"id": "PL8mG-RkN2uTwcE8ceu8yAjExyRvw5DsA6",
"url": "https://www.youtube.com/playlist?list=PL8mG-RkN2uTwcE8ceu8yAjExyRvw5DsA6",
"title": "Secret Shopper",
"description": "We put your favourite tech companies to the test on how well they handle the customer experience- from ordering and shipping, through to customer service and repair. Then we rank them accordingly...",
"links": [],
"type": "playlist",
"owner": {
"id": "UCXuqSBlHAE6Xw-yeJA0Tunw",
"name": "Linus Tech Tips",
"handle": "LinusTechTips",
"url": "https://www.youtube.com/@LinusTechTips",
"avatarUrl": "https://yt3.ggpht.com/gnvYLhXy8FAlPXZ2RTrkrgj-5kyt0vdE2FUGVOiKGdEZIa-wN5A-7nwZBlWJLzUMmoh1NWAU=s176-c-k-c0x00ffffff-no-rj"
},
"videoCount": 24,
"videoCountText": "24 videos",
"viewCount": 80081,
"lastUpdatedAt": "2026-06-18",
"lastUpdatedText": "Last updated on Jun 18, 2026",
"unavailableVideoCount": 0,
"isUnlisted": false,
"thumbnailUrl": "https://i.ytimg.com/vi/Clrj_lSDvzQ/hqdefault.jpg?sqp=-oaymwEXCOADEI4CSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLC1C0WNOwIT4majHh4P8uYoWRCYcA&days_since_epoch=20762",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/Clrj_lSDvzQ/hqdefault.jpg?sqp=-oaymwEXCOADEI4CSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLC1C0WNOwIT4majHh4P8uYoWRCYcA&days_since_epoch=20762",
"width": 480,
"height": 270
},
{
"url": "https://i.ytimg.com/vi/Clrj_lSDvzQ/hqdefault.jpg?sqp=-oaymwEXCNACELwBSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLCrh-P4qrYyxRGOanGZ3z8bor82tg",
"width": 336,
"height": 188
},
{
"url": "https://i.ytimg.com/vi/Clrj_lSDvzQ/hqdefault.jpg?sqp=-oaymwEXCPYBEIoBSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLAwy2nm2gc1fK1D6EROd3UkUApgsg",
"width": 246,
"height": 138
}
]
},
"videos": [
{
"position": 1,
"id": "Clrj_lSDvzQ",
"url": "https://www.youtube.com/watch?v=Clrj_lSDvzQ",
"title": "Buying a Gaming PC at Best Buy – How Bad is it?",
"channel": {
"id": "UCXuqSBlHAE6Xw-yeJA0Tunw",
"name": "Linus Tech Tips",
"handle": "LinusTechTips",
"url": "https://www.youtube.com/@LinusTechTips",
"avatarUrl": "https://yt3.ggpht.com/gnvYLhXy8FAlPXZ2RTrkrgj-5kyt0vdE2FUGVOiKGdEZIa-wN5A-7nwZBlWJLzUMmoh1NWAU=s68-c-k-c0x00ffffff-no-rj",
"isVerified": true,
"isOfficialArtist": false
},
"collaborators": [],
"viewCount": 4600000,
"viewCountText": "4.6M views",
"publishedText": "10 years ago",
"durationSeconds": 492,
"durationText": "8:12",
"isLive": false,
"concurrentViewers": null,
"isUpcoming": false,
"scheduledStartAt": null,
"waitingCount": null,
"isMembersOnly": false,
"isShort": false,
"badges": [],
"thumbnailUrl": "https://i.ytimg.com/vi/Clrj_lSDvzQ/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDmSlpYYvU0A7q7PA0afkVQSDjxEg",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/Clrj_lSDvzQ/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDmSlpYYvU0A7q7PA0afkVQSDjxEg",
"width": 336,
"height": 188
},
{
"url": "https://i.ytimg.com/vi/Clrj_lSDvzQ/hqdefault.jpg?sqp=-oaymwEcCPYBEIoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLD4Um-fY75diia12MI1Tv6dwPFRRA",
"width": 246,
"height": 138
},
{
"url": "https://i.ytimg.com/vi/Clrj_lSDvzQ/hqdefault.jpg?sqp=-oaymwEbCMQBEG5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLDI7TIXHrcs_T7Ik83oy9zB2KHc8A",
"width": 196,
"height": 110
}
],
"frameUrl": null
},
{
"position": 2,
"id": "rzpYkpZX8qw",
"url": "https://www.youtube.com/watch?v=rzpYkpZX8qw",
"title": "Are PC Manufacturers Ripping You Off? - $1500 Gaming PC Secret Shopper Part 1",
"channel": {
"id": "UCXuqSBlHAE6Xw-yeJA0Tunw",
"name": "Linus Tech Tips",
"handle": "LinusTechTips",
"url": "https://www.youtube.com/@LinusTechTips",
"avatarUrl": "https://yt3.ggpht.com/gnvYLhXy8FAlPXZ2RTrkrgj-5kyt0vdE2FUGVOiKGdEZIa-wN5A-7nwZBlWJLzUMmoh1NWAU=s68-c-k-c0x00ffffff-no-rj",
"isVerified": true,
"isOfficialArtist": false
},
"collaborators": [],
"viewCount": 4300000,
"viewCountText": "4.3M views",
"publishedText": "7 years ago",
"durationSeconds": 1467,
"durationText": "24:27",
"isLive": false,
"concurrentViewers": null,
"isUpcoming": false,
"scheduledStartAt": null,
"waitingCount": null,
"isMembersOnly": false,
"isShort": false,
"badges": [],
"thumbnailUrl": "https://i.ytimg.com/vi/rzpYkpZX8qw/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBvN2JdFXKSi2fsSJ4RQGeDrbdq0w",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/rzpYkpZX8qw/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBvN2JdFXKSi2fsSJ4RQGeDrbdq0w",
"width": 336,
"height": 188
},
{
"url": "https://i.ytimg.com/vi/rzpYkpZX8qw/hqdefault.jpg?sqp=-oaymwEcCPYBEIoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDB2X9BthLGbgIYwtitgHjePK3tJw",
"width": 246,
"height": 138
},
{
"url": "https://i.ytimg.com/vi/rzpYkpZX8qw/hqdefault.jpg?sqp=-oaymwEbCMQBEG5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLBVUBB3uLJCXGu7zQA-n9WZWbgMZg",
"width": 196,
"height": 110
}
],
"frameUrl": null
},
{
"position": 3,
"id": "yGoCMDrzCq0",
"url": "https://www.youtube.com/watch?v=yGoCMDrzCq0",
"title": "What did we BUY?? - $1500 Gaming PC Secret Shopper Part 2",
"channel": {
"id": "UCXuqSBlHAE6Xw-yeJA0Tunw",
"name": "Linus Tech Tips",
"handle": "LinusTechTips",
"url": "https://www.youtube.com/@LinusTechTips",
"avatarUrl": "https://yt3.ggpht.com/gnvYLhXy8FAlPXZ2RTrkrgj-5kyt0vdE2FUGVOiKGdEZIa-wN5A-7nwZBlWJLzUMmoh1NWAU=s68-c-k-c0x00ffffff-no-rj",
"isVerified": true,
"isOfficialArtist": false
},
"collaborators": [],
"viewCount": 3500000,
"viewCountText": "3.5M views",
"publishedText": "7 years ago",
"durationSeconds": 1734,
"durationText": "28:54",
"isLive": false,
"concurrentViewers": null,
"isUpcoming": false,
"scheduledStartAt": null,
"waitingCount": null,
"isMembersOnly": false,
"isShort": false,
"badges": [],
"thumbnailUrl": "https://i.ytimg.com/vi/yGoCMDrzCq0/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLClu02kkxUmgbE9l-Z5w-_7TSt71Q",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/yGoCMDrzCq0/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLClu02kkxUmgbE9l-Z5w-_7TSt71Q",
"width": 336,
"height": 188
},
{
"url": "https://i.ytimg.com/vi/yGoCMDrzCq0/hqdefault.jpg?sqp=-oaymwEcCPYBEIoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLA11wNqTSnAU-3ZlcAJGfMA0UMOZQ",
"width": 246,
"height": 138
},
{
"url": "https://i.ytimg.com/vi/yGoCMDrzCq0/hqdefault.jpg?sqp=-oaymwEbCMQBEG5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLC4kRGLCj-Y43fpnU8c89Wib5nWsw",
"width": 196,
"height": 110
}
],
"frameUrl": null
}
],
"count": 24,
"cursor": null,
"hasMore": false,
"fetchedAt": "2026-11-05T13:52:13.155Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}{
"error": {
"code": "BAD_REQUEST",
"message": "The request was invalid.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "API key required — pass it in the `x-api-key` header.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "INSUFFICIENT_CREDITS",
"message": "This request costs 1 credit, but your balance is 0. Top up to continue.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "The requested content was not found (it may not exist, be deleted, or be private).",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"details": [
{
"path": "url",
"message": "url is required"
}
]
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded — max 100 requests per 60s. Retry in ~30s.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UPSTREAM_BLOCKED",
"message": "The source is temporarily unavailable. Please try again shortly.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}YouTube
Playlist videos
Fetches the videos in a YouTube playlist, 100 per page, in the playlist’s order. Each video has its position, id, URL, title, channel (id, handle, name, avatar, verified) and, for a collaboration, every credited channel; its views and publish time as YouTube lists them (rounded / relative), length, thumbnail and moving preview; and whether it is live now (with viewers), scheduled (start time, people waiting) or members-only. The response also describes the playlist on every page: title, full description and its links, kind (playlist, podcast or course), owner, video count, exact total views, when it was last updated, how many unavailable videos YouTube hides, whether it is unlisted, and its cover. Works for any public or unlisted playlist, including a channel’s uploads (UU…), Shorts (UUSH…, one page of up to 100) and live (UULV…) lists. Pass the returned cursor back (with the same playlistId) for the next page. Private playlists and Mixes (RD…) return 404. Only publicly available data is returned.
GET
/
v1
/
youtube
/
playlist
Playlist videos
curl --request GET \
--url https://api.scraperize.com/v1/youtube/playlist \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/youtube/playlist"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.scraperize.com/v1/youtube/playlist', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.scraperize.com/v1/youtube/playlist",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.scraperize.com/v1/youtube/playlist"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.scraperize.com/v1/youtube/playlist")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/youtube/playlist")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"playlist": {
"id": "PL8mG-RkN2uTwcE8ceu8yAjExyRvw5DsA6",
"url": "https://www.youtube.com/playlist?list=PL8mG-RkN2uTwcE8ceu8yAjExyRvw5DsA6",
"title": "Secret Shopper",
"description": "We put your favourite tech companies to the test on how well they handle the customer experience- from ordering and shipping, through to customer service and repair. Then we rank them accordingly...",
"links": [],
"type": "playlist",
"owner": {
"id": "UCXuqSBlHAE6Xw-yeJA0Tunw",
"name": "Linus Tech Tips",
"handle": "LinusTechTips",
"url": "https://www.youtube.com/@LinusTechTips",
"avatarUrl": "https://yt3.ggpht.com/gnvYLhXy8FAlPXZ2RTrkrgj-5kyt0vdE2FUGVOiKGdEZIa-wN5A-7nwZBlWJLzUMmoh1NWAU=s176-c-k-c0x00ffffff-no-rj"
},
"videoCount": 24,
"videoCountText": "24 videos",
"viewCount": 80081,
"lastUpdatedAt": "2026-06-18",
"lastUpdatedText": "Last updated on Jun 18, 2026",
"unavailableVideoCount": 0,
"isUnlisted": false,
"thumbnailUrl": "https://i.ytimg.com/vi/Clrj_lSDvzQ/hqdefault.jpg?sqp=-oaymwEXCOADEI4CSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLC1C0WNOwIT4majHh4P8uYoWRCYcA&days_since_epoch=20762",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/Clrj_lSDvzQ/hqdefault.jpg?sqp=-oaymwEXCOADEI4CSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLC1C0WNOwIT4majHh4P8uYoWRCYcA&days_since_epoch=20762",
"width": 480,
"height": 270
},
{
"url": "https://i.ytimg.com/vi/Clrj_lSDvzQ/hqdefault.jpg?sqp=-oaymwEXCNACELwBSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLCrh-P4qrYyxRGOanGZ3z8bor82tg",
"width": 336,
"height": 188
},
{
"url": "https://i.ytimg.com/vi/Clrj_lSDvzQ/hqdefault.jpg?sqp=-oaymwEXCPYBEIoBSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLAwy2nm2gc1fK1D6EROd3UkUApgsg",
"width": 246,
"height": 138
}
]
},
"videos": [
{
"position": 1,
"id": "Clrj_lSDvzQ",
"url": "https://www.youtube.com/watch?v=Clrj_lSDvzQ",
"title": "Buying a Gaming PC at Best Buy – How Bad is it?",
"channel": {
"id": "UCXuqSBlHAE6Xw-yeJA0Tunw",
"name": "Linus Tech Tips",
"handle": "LinusTechTips",
"url": "https://www.youtube.com/@LinusTechTips",
"avatarUrl": "https://yt3.ggpht.com/gnvYLhXy8FAlPXZ2RTrkrgj-5kyt0vdE2FUGVOiKGdEZIa-wN5A-7nwZBlWJLzUMmoh1NWAU=s68-c-k-c0x00ffffff-no-rj",
"isVerified": true,
"isOfficialArtist": false
},
"collaborators": [],
"viewCount": 4600000,
"viewCountText": "4.6M views",
"publishedText": "10 years ago",
"durationSeconds": 492,
"durationText": "8:12",
"isLive": false,
"concurrentViewers": null,
"isUpcoming": false,
"scheduledStartAt": null,
"waitingCount": null,
"isMembersOnly": false,
"isShort": false,
"badges": [],
"thumbnailUrl": "https://i.ytimg.com/vi/Clrj_lSDvzQ/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDmSlpYYvU0A7q7PA0afkVQSDjxEg",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/Clrj_lSDvzQ/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDmSlpYYvU0A7q7PA0afkVQSDjxEg",
"width": 336,
"height": 188
},
{
"url": "https://i.ytimg.com/vi/Clrj_lSDvzQ/hqdefault.jpg?sqp=-oaymwEcCPYBEIoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLD4Um-fY75diia12MI1Tv6dwPFRRA",
"width": 246,
"height": 138
},
{
"url": "https://i.ytimg.com/vi/Clrj_lSDvzQ/hqdefault.jpg?sqp=-oaymwEbCMQBEG5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLDI7TIXHrcs_T7Ik83oy9zB2KHc8A",
"width": 196,
"height": 110
}
],
"frameUrl": null
},
{
"position": 2,
"id": "rzpYkpZX8qw",
"url": "https://www.youtube.com/watch?v=rzpYkpZX8qw",
"title": "Are PC Manufacturers Ripping You Off? - $1500 Gaming PC Secret Shopper Part 1",
"channel": {
"id": "UCXuqSBlHAE6Xw-yeJA0Tunw",
"name": "Linus Tech Tips",
"handle": "LinusTechTips",
"url": "https://www.youtube.com/@LinusTechTips",
"avatarUrl": "https://yt3.ggpht.com/gnvYLhXy8FAlPXZ2RTrkrgj-5kyt0vdE2FUGVOiKGdEZIa-wN5A-7nwZBlWJLzUMmoh1NWAU=s68-c-k-c0x00ffffff-no-rj",
"isVerified": true,
"isOfficialArtist": false
},
"collaborators": [],
"viewCount": 4300000,
"viewCountText": "4.3M views",
"publishedText": "7 years ago",
"durationSeconds": 1467,
"durationText": "24:27",
"isLive": false,
"concurrentViewers": null,
"isUpcoming": false,
"scheduledStartAt": null,
"waitingCount": null,
"isMembersOnly": false,
"isShort": false,
"badges": [],
"thumbnailUrl": "https://i.ytimg.com/vi/rzpYkpZX8qw/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBvN2JdFXKSi2fsSJ4RQGeDrbdq0w",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/rzpYkpZX8qw/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBvN2JdFXKSi2fsSJ4RQGeDrbdq0w",
"width": 336,
"height": 188
},
{
"url": "https://i.ytimg.com/vi/rzpYkpZX8qw/hqdefault.jpg?sqp=-oaymwEcCPYBEIoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDB2X9BthLGbgIYwtitgHjePK3tJw",
"width": 246,
"height": 138
},
{
"url": "https://i.ytimg.com/vi/rzpYkpZX8qw/hqdefault.jpg?sqp=-oaymwEbCMQBEG5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLBVUBB3uLJCXGu7zQA-n9WZWbgMZg",
"width": 196,
"height": 110
}
],
"frameUrl": null
},
{
"position": 3,
"id": "yGoCMDrzCq0",
"url": "https://www.youtube.com/watch?v=yGoCMDrzCq0",
"title": "What did we BUY?? - $1500 Gaming PC Secret Shopper Part 2",
"channel": {
"id": "UCXuqSBlHAE6Xw-yeJA0Tunw",
"name": "Linus Tech Tips",
"handle": "LinusTechTips",
"url": "https://www.youtube.com/@LinusTechTips",
"avatarUrl": "https://yt3.ggpht.com/gnvYLhXy8FAlPXZ2RTrkrgj-5kyt0vdE2FUGVOiKGdEZIa-wN5A-7nwZBlWJLzUMmoh1NWAU=s68-c-k-c0x00ffffff-no-rj",
"isVerified": true,
"isOfficialArtist": false
},
"collaborators": [],
"viewCount": 3500000,
"viewCountText": "3.5M views",
"publishedText": "7 years ago",
"durationSeconds": 1734,
"durationText": "28:54",
"isLive": false,
"concurrentViewers": null,
"isUpcoming": false,
"scheduledStartAt": null,
"waitingCount": null,
"isMembersOnly": false,
"isShort": false,
"badges": [],
"thumbnailUrl": "https://i.ytimg.com/vi/yGoCMDrzCq0/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLClu02kkxUmgbE9l-Z5w-_7TSt71Q",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/yGoCMDrzCq0/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLClu02kkxUmgbE9l-Z5w-_7TSt71Q",
"width": 336,
"height": 188
},
{
"url": "https://i.ytimg.com/vi/yGoCMDrzCq0/hqdefault.jpg?sqp=-oaymwEcCPYBEIoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLA11wNqTSnAU-3ZlcAJGfMA0UMOZQ",
"width": 246,
"height": 138
},
{
"url": "https://i.ytimg.com/vi/yGoCMDrzCq0/hqdefault.jpg?sqp=-oaymwEbCMQBEG5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLC4kRGLCj-Y43fpnU8c89Wib5nWsw",
"width": 196,
"height": 110
}
],
"frameUrl": null
}
],
"count": 24,
"cursor": null,
"hasMore": false,
"fetchedAt": "2026-11-05T13:52:13.155Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}{
"error": {
"code": "BAD_REQUEST",
"message": "The request was invalid.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "API key required — pass it in the `x-api-key` header.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "INSUFFICIENT_CREDITS",
"message": "This request costs 1 credit, but your balance is 0. Top up to continue.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "The requested content was not found (it may not exist, be deleted, or be private).",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"details": [
{
"path": "url",
"message": "url is required"
}
]
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded — max 100 requests per 60s. Retry in ~30s.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UPSTREAM_BLOCKED",
"message": "The source is temporarily unavailable. Please try again shortly.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}Cost: 1 credit per successful request. Errors and cache hits (
cache_max_age) are free.Copy for AI assistant
Copy for AI assistant
Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button).
Prompt
I want to make an API call to /v1/youtube/playlist. Here are the details:
Endpoint: GET https://api.scraperize.com/v1/youtube/playlist
Description: Fetches the videos in a YouTube playlist, 100 per page, in the playlist's order. Each video has its position, id, URL, title, channel (id, handle, name, avatar, verified) and, for a collaboration, every credited channel; its views and publish time as YouTube lists them (rounded / relative), length, thumbnail and moving preview; and whether it is live now (with viewers), scheduled (start time, people waiting) or members-only. The response also describes the playlist on every page: title, full description and its links, kind (`playlist`, `podcast` or `course`), owner, video count, exact total views, when it was last updated, how many unavailable videos YouTube hides, whether it is unlisted, and its cover. Works for any public or unlisted playlist, including a channel's uploads (`UU…`), Shorts (`UUSH…`, one page of up to 100) and live (`UULV…`) lists. Pass the returned `cursor` back (with the same `playlistId`) for the next page. Private playlists and Mixes (`RD…`) return 404. Only publicly available data is returned.
Required Headers:
- x-api-key: Your API key
Parameters:
- playlistId (string) [required]: The playlist id — the `list` value of a playlist URL (`youtube.com/playlist?list=<playlistId>`), e.g. `PL8mG-RkN2uTwcE8ceu8yAjExyRvw5DsA6`.
- cursor (string): The `cursor` from the previous page, to get the next one. Omit for the first page.
- cache_max_age (select): Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh.
Example Response:
{
"data": {
"playlist": {
"id": "PL8mG-RkN2uTwcE8ceu8yAjExyRvw5DsA6",
"url": "https://www.youtube.com/playlist?list=PL8mG-RkN2uTwcE8ceu8yAjExyRvw5DsA6",
"title": "Secret Shopper",
"description": "We put your favourite tech companies to the test on how well they handle the customer experience- from ordering and shipping, through to customer service and r…",
"links": [],
"type": "playlist",
"owner": {
"id": "UCXuqSBlHAE6Xw-yeJA0Tunw",
"name": "Linus Tech Tips",
"handle": "LinusTechTips",
"url": "https://www.youtube.com/@LinusTechTips",
"avatarUrl": "https://yt3.ggpht.com/gnvYLhXy8FAlPXZ2RTrkrgj-5kyt0vdE2FUGVOiKGdEZIa-wN5A-7nwZBlWJLzUMmoh1NWAU=s176-c-k-c0x00ffffff-no-rj"
},
"videoCount": 24,
"videoCountText": "24 videos",
"viewCount": 80081,
"lastUpdatedAt": "2026-06-18",
"lastUpdatedText": "Last updated on Jun 18, 2026",
"unavailableVideoCount": 0,
"isUnlisted": false,
"thumbnailUrl": "https://i.ytimg.com/vi/Clrj_lSDvzQ/hqdefault.jpg?sqp=-oaymwEXCOADEI4CSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLC1C0WNOwIT4majHh4P8uYoWRCYcA&days_since_epoch=20762",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/Clrj_lSDvzQ/hqdefault.jpg?sqp=-oaymwEXCOADEI4CSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLC1C0WNOwIT4majHh4P8uYoWRCYcA&days_since_epoch=20762",
"width": 480,
"height": 270
}
]
},
"videos": [
{
"position": 1,
"id": "Clrj_lSDvzQ",
"url": "https://www.youtube.com/watch?v=Clrj_lSDvzQ",
"title": "Buying a Gaming PC at Best Buy – How Bad is it?",
"channel": {
"id": "UCXuqSBlHAE6Xw-yeJA0Tunw",
"name": "Linus Tech Tips",
"handle": "LinusTechTips",
"url": "https://www.youtube.com/@LinusTechTips",
"avatarUrl": "https://yt3.ggpht.com/gnvYLhXy8FAlPXZ2RTrkrgj-5kyt0vdE2FUGVOiKGdEZIa-wN5A-7nwZBlWJLzUMmoh1NWAU=s68-c-k-c0x00ffffff-no-rj",
"isVerified": true,
"isOfficialArtist": false
},
"collaborators": [],
"viewCount": 4600000,
"viewCountText": "4.6M views",
"publishedText": "10 years ago",
"durationSeconds": 492,
"durationText": "8:12",
"isLive": false,
"concurrentViewers": null,
"isUpcoming": false,
"scheduledStartAt": null,
"waitingCount": null,
"isMembersOnly": false,
"isShort": false,
"badges": [],
"thumbnailUrl": "https://i.ytimg.com/vi/Clrj_lSDvzQ/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDmSlpYYvU0A7q7PA0afkVQSDjxEg",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/Clrj_lSDvzQ/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDmSlpYYvU0A7q7PA0afkVQSDjxEg",
"width": 336,
"height": 188
}
],
"frameUrl": null
}
],
"count": 24,
"cursor": null,
"hasMore": false,
"fetchedAt": "2026-11-05T13:52:13.155Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}
Please help me write code in my preferred programming language to make this API call and handle the response appropriately. Include error handling and best practices.
Authorizations
Your API key. Send it in the x-api-key header (or Authorization: Bearer <key>). Create and manage keys from your dashboard.
Query Parameters
The playlist id — the list value of a playlist URL (youtube.com/playlist?list=<playlistId>), e.g. PL8mG-RkN2uTwcE8ceu8yAjExyRvw5DsA6.
The cursor from the previous page, to get the next one. Omit for the first page.
Optional. Return a cached result if one this age or newer exists — served for 0 credits with meta.cached=true and meta.cachedAt. Otherwise a fresh scrape runs (1 credit) and refreshes the cache. Omit to always scrape fresh.
Available options:
1d, 3d, 7d, 14d, 30d