List YouTube channel playlists

List the playlists on a YouTube channel's Playlists tab.

GET/v1/youtube/channels/playlists
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
channelIdstringquery

YouTube channel id whose playlists should be listed, such as `UCHnyfMqiRRG1u-2MsSQLbXA`.

min 1 chars · max 4096 chars

handlestringquery

YouTube channel handle whose playlists should be listed, with or without a leading @.

cursorstringquery

Pass `page.nextCursor` from the previous response to get the next page.

min 1 chars · max 8192 chars

Response fields
24

Endpoint-specific response payload.

datalookupStatus
string

Whether the channel was found. `found` may still have no playlists.

one of: found, not_found

The channel, from its playlists; null when it has none.

datachannelplatform
string

Social platform for this channel.

one of: youtube

datachannelplatformUserId
stringnullable

YouTube channel id when available.

datachannelhandle
stringnullable

YouTube channel handle without the leading @, when available.

datachanneldisplayName
stringnullable

Public display name of the channel when available.

datachannelprofileUrl
stringnullable

Public YouTube channel URL when available.

Playlists on this page, in the order the channel shows them.

dataplaylists[]id
string

YouTube playlist identifier.

min 1 chars

dataplaylists[]url
string

Public YouTube URL for the playlist.

min 1 chars

dataplaylists[]title
stringnullable

Playlist title when available.

dataplaylists[]thumbnailUrl
stringnullable

Playlist thumbnail image URL when available.

dataplaylists[]videoCount
integernullable

Number of videos in the playlist when available.

≥ 0

dataplaylists[]firstVideoId
stringnullable

Id of the playlist's first video, which YouTube uses as its cover, when available.

Pagination information for the current response.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/youtube/channels/playlists?handle=veritasium" \
  -H "x-api-key: YOUR_API_KEY"

Responses

YouTube channel playlists.