Get YouTube playlist

Get a YouTube playlist by playlist id.

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

API key (`sfk_...`)

Parameters
2
playlistIdstringrequiredquery

YouTube playlist id, or a YouTube playlist URL (the `list` query value is used when present).

min 1 chars · max 4096 chars

cursorstringoptionalquery

Opaque pagination cursor from `data.page.nextCursor` of a previous response. Omit for the first page. Send the same `playlistId` on every page.

min 1 chars · max 8192 chars

Response fields
30

Endpoint-specific response payload.

datalookupStatus
string

Whether the playlist was resolved for this request.

one of: found, not_found

Playlist summary when found. On pages after the first, `title`, `owner` and `totalVideos` are null.

dataplaylistid
string

YouTube playlist identifier.

min 1 chars

dataplaylisttitle
stringnullable

Playlist title when available.

Playlist owner when available.

dataplaylistownerplatform
string

Social platform for this channel.

one of: youtube

dataplaylistownerplatformUserId
stringnullable

YouTube channel id when available.

dataplaylistownerhandle
stringnullable

YouTube channel handle without a leading @ when available.

dataplaylistownerdisplayName
stringnullable

Public display name for the playlist owner when available.

dataplaylistownerprofileUrl
stringnullable

Canonical public YouTube channel URL when available.

dataplaylisttotalVideos
integernullable

Reported total number of videos in the playlist when available.

≥ 0

Videos in the playlist when found. This array is empty when the playlist is not found.

datavideos[]id
string

YouTube video identifier.

min 1 chars

datavideos[]title
stringnullable

Video title when available.

datavideos[]url
stringnullable

Canonical public YouTube URL for the video when available.

datavideos[]thumbnailUrl
stringnullable

Best available thumbnail image URL when available.

datavideos[]durationSeconds
integernullable

Duration of the video in seconds when available.

≥ 0

datavideos[]durationText
stringnullable

Human-readable duration label when available.

datavideos[]channelTitle
stringnullable

Uploader channel title shown for the video when available.

datavideos[]channelUrl
stringnullable

Uploader channel URL when available.

Pagination information for the current response.

datapagenextCursor
stringnullable

Cursor to pass as `cursor` in the next request when `hasMore` is true; otherwise null.

datapagehasMore
boolean

Whether another page of playlist videos is available.

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/playlists?playlistId=PLP32wGpgzmIlInfgKVFfCwVsxgGqZNIiS" \
  -H "x-api-key: YOUR_API_KEY"

Responses

YouTube playlist lookup result.