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
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
Endpoint-specific response payload.
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.
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.
Pagination information for the current response.
Cursor to pass as `cursor` in the next request when `hasMore` is true; otherwise null.
Whether another page of playlist videos is 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
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
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.