YouTube Channel Playlists API
Every playlist on a channel's Playlists tab, with its title, cover and video count.
GET /v1/youtube/channels/playlists1 credit Failed requests are free
About this endpoint
GET /v1/youtube/channels/playlists takes a handle or channelId and returns data.playlists in the order the channel shows them. Each playlist has id, url, title, thumbnailUrl, videoCount and firstVideoId; data.channel identifies the channel. Pass data.page.nextCursor as cursor while data.page.hasMore is true.
An unknown channel is data.lookupStatus: not_found. To read the videos in one playlist, pass its id to GET /v1/youtube/playlists.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
YouTube Channel Playlists API FAQ
How do I list a YouTube channel's playlists via API?
Call GET /v1/youtube/channels/playlists with your Social Fetch API key (x-api-key) and a handle or channelId. Read data.playlists, and page with data.page.nextCursor.
How much does the YouTube Channel Playlists API cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.
How do I get the videos inside a playlist?
Pass the playlist's id to GET /v1/youtube/playlists, which lists its videos page by page.
Does it include playlists a channel hides?
No. It lists what the channel shows publicly on its Playlists tab. Private and unlisted playlists are not shown there.
Other YouTube endpoints
- ChannelGET /v1/youtube/channel
- Channel videosGET /v1/youtube/channels/videos
- Channel shortsGET /v1/youtube/channels/shorts
- Channel searchGET /v1/youtube/channels/search
- Channel community postsGET /v1/youtube/channels/community-posts
- Channel live streamsGET /v1/youtube/channels/live-streams
- PlaylistGET /v1/youtube/playlists
- Community postGET /v1/youtube/community-posts