YouTube hub

YouTube Channel Playlists API

Every playlist on a channel's Playlists tab, with its title, cover and video count.

GET /v1/youtube/channels/playlists

1 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.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

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.