Get YouTube playlist
Get a YouTube playlist.
Use `data.lookupStatus` to distinguish a resolved playlist from `not_found`.
An empty `data.videos` array with `data.lookupStatus: "found"` means the playlist resolved but returned no videos in the response.
Headers
Get your API keyAPI key (`sfk_...`)
YouTube playlist id, or a YouTube playlist URL (the `list` query value is used when present).
min 1 chars · max 4096 chars
Endpoint-specific response payload.
Whether the playlist was resolved for this request.
one of: found, not_found
Playlist summary when found.
YouTube playlist identifier.
min 1 chars
Playlist title when available.
Playlist owner when available.
Social platform for this channel.
one of: youtube
YouTube channel id when available.
YouTube channel handle without a leading @ when available.
Public display name for the playlist owner when available.
Canonical public YouTube channel URL when available.
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.
YouTube video identifier.
min 1 chars
Video title when available.
Canonical public YouTube URL for the video when available.
Best available thumbnail image URL when available.
Duration of the video in seconds when available.
≥ 0
Human-readable duration label when available.
Uploader channel title shown for the video when available.
Uploader channel URL when available.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/youtube/playlists?playlistId=PLP32wGpgzmIlInfgKVFfCwVsxgGqZNIiS" \
-H "x-api-key: YOUR_API_KEY"Responses
YouTube playlist lookup result. Check `data.lookupStatus` for `found` vs `not_found`.