POST /v1/youtube/playlistYouTube Playlist Scraper API
A YouTube playlist by URL or ID: title, description, owner channel, video and view counts, plus its videos (max 100) with views, publish time and duration.
- Cost
- 1 credit
- Failed requests
- Refunded
- Cache hits
- Free
- Response fields
- 13
- Limits
- First 100 videos
What the YouTube Playlist Scraper API does
The YouTube Playlist Scraper API returns a public YouTube playlist by URL or ID: title, description, owner channel, thumbnail, the exact number of videos and total views, plus the videos themselves in playlist order, up to 100 per request. Each video has its ID, link, title, channel, view count, relative publish time, duration and thumbnail, and a flag for videos that are live right now. Send a playlist URL, any YouTube link with a list= parameter or a playlist ID (PL..., OLAK5uy_..., UU...). Video view counts are YouTube's rounded figures, while the playlist's own view and video counts are exact. Unavailable videos are hidden by YouTube, so a page can hold fewer than 100. Each request costs 1 credit.
What you get
Top-level fields of the response. Every field is typed and documented; nullable fields are null when the platform does not show them.
| Field | Type | Description |
|---|---|---|
playlist_id | string | Playlist ID |
title | string | Playlist title |
description | string | Playlist description |
channel | object | null | Owner channel |
video_count | integer | null | Number of videos in the playlist |
video_count_text | string | null | Raw text, e.g. '43 videos' |
view_count | integer | null | Total playlist views |
view_count_text | string | null | Raw text, e.g. '306,365 views' |
thumbnail_url | string | null | Playlist thumbnail URL |
url | string | Playlist URL |
videos_fetched | integer | Number of videos returned |
has_more | boolean | The playlist has more videos than returned |
videos | array<object> (11 fields each) | Videos in playlist order, max limit |
Request example
Send the API key as a Bearer token. The body is a small JSON object.
curl -X POST https://api.scrapeeverything.com/v1/youtube/playlist \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.youtube.com/playlist?list=PLOzDu-MXXLlj7croDcwz33c-a5rpNEBNe","limit":10}'| Parameter | Required | Description |
|---|---|---|
url | No | Playlist URL or any YouTube link with a list= parameter (a bare playlist ID also works). |
id | No | Playlist ID (PL..., OLAK5uy_..., UU...). |
limit | No | Maximum number of videos to return. |
What it costs
Each successful request costs 1 credit. Your first 100 credits are free. With credit packs, 1,000 requests to this endpoint cost:
Builder pack
$1.56
25,000 credits for $39.00
Growth pack
$1.19
100,000 credits for $119.00
Scale pack
$0.90
500,000 credits for $449.00
See pricing for all packs and rate limits.
Use cases
- Index course, tutorial and series playlists to feed into transcript pipelines.
- Monitor curated playlists and detect which videos are added or removed.
- Report total playlist views and video counts for content series.
Limitations: Unofficial API: not affiliated with or endorsed by the platform. Public data only, as a logged-out visitor sees it. Counts can be YouTube's rounded figures; comments are top-level only; transcripts exist only for videos with captions.
- Returns the first page of the playlist (up to 100 videos). Unavailable videos are hidden by YouTube, so a page can hold fewer than 100.
- Video view counts are YouTube's rounded figures (for example 4.4M); playlist view and video counts are exact.
- Returns 404 when the playlist does not exist or is private.
Questions
How many videos are returned?
The first page of the playlist, up to 100 videos (default 50). Unavailable videos are hidden by YouTube, so fewer can come back.
Do private playlists work?
No. Private or non-existent playlists return 404.
Are the counts exact?
The playlist's view_count and video_count are exact. View counts of the individual videos are YouTube's rounded figures, for example 4.4M.
How much does the YouTube Playlist Scraper API cost?
1 credit per successful request. Credits are bought in one-time packs and never expire. New accounts get 100 free credits. No payment details needed.
Am I charged for failed requests?
No. If the platform blocks the request, it times out or something fails on our side, the credits are refunded automatically. A definitive answer such as "this account does not exist" is billed because the lookup completed.
Can I re-read a result without paying again?
Yes. Send cache_days (1 to 14) and a repeat request for the same target within that window is served from your cache for free.
More YouTube endpoints
Start with 100 free credits.
Continue with Google, create an API key and send your first request in under a minute.