API reference / YouTube / Playlists list

Playlists list

Read-only YouTube Data API v3 playlists list endpoint.

1 credit per successful call Errors are never charged

Request

GET https://socialgraph.dev/api/v1/youtube/playlists

Send your API key as Authorization: Bearer YOUR_API_KEY. Parameters go in the query string.

Parameters

Name	Type	Description
`part` required	string	Required. Comma-separated: id, snippet, contentDetails, status, player or localizations. For example: snippet,contentDetails
`channelId` optional	string	Playlists of this channel (provide channelId or id). For example: UC_x5XG1OV2P6uZZ5FSM9Ttw
`id` optional	string	Comma-separated playlist IDs (provide channelId or id).
`maxResults` optional	integer	Maximum results per page (0–50). Default 5.
`pageToken` optional	string	Token from a previous response (nextPageToken or prevPageToken).
`hl` optional	string	Language for localized titles and descriptions. For example: es

Code examples

Example response

{
    "etag": "d6RoTsLW2HyyPXuz5ZouYUvcR0I",
    "kind": "youtube#playlistListResponse",
    "items": [
        {
            "id": "PLRPUpQa70I6A",
            "etag": "YNK0feSjD7rNXuO9z6cqfC3TlrY",
            "kind": "youtube#playlist",
            "snippet": {
                "title": "Building with Gemini",
                "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "localized": {
                    "title": "Building with Gemini",
                    "description": "Real makers. Working prototypes. Created with Gemini.\n\nWatch as we spotlight a developer using Gemini to bring a unique build to life—from turning computers into musical instruments to physical hardware automation and daily receipt printing.\n\nSee what’s actually possible when you treat Gemini like a core engineering tool."
                },
                "thumbnails": {
                    "fhd": {
                        "url": "https://i.ytimg.com/vi/Rnz9mOyxk0k/fhddefault.jpg",
                        "width": 1920,
                        "height": 1080
                    },
                    "high": {
                        "url": "https://i.ytimg.com/vi/Rnz9mOyxk0k/hqdefault.jpg",
                        "width": 480,
                        "height": 360
                    },
                    "maxres": {
                        "url": "https://i.ytimg.com/vi/Rnz9mOyxk0k/maxresdefault.jpg",
                        "width": 1280,
                        "height": 720
                    },
                    "medium": {
                        "url": "https://i.ytimg.com/vi/Rnz9mOyxk0k/mqdefault.jpg",
                        "width": 320,
                        "height": 180
                    },
                    "default": {
                        "url": "https://i.ytimg.com/vi/Rnz9mOyxk0k/default.jpg",
                        "width": 120,
                        "height": 90
                    },
                    "standard": {
                        "url": "https://i.ytimg.com/vi/Rnz9mOyxk0k/sddefault.jpg",
                        "width": 640,
                        "height": 480
                    }
                },
                "description": "Real makers. Working prototypes. Created with Gemini.\n\nWatch as we spotlight a developer using Gemini to bring a unique build to life—from turning computers into musical instruments to physical hardware automation and daily receipt printing.\n\nSee what’s actually possible when you treat Gemini like a core engineering tool.",
                "publishedAt": "2026-09-28T16:23:06.654575931Z",
                "channelTitle": "Google for Developers",
                "defaultLanguage": "en"
            },
            "contentDetails": {
                "itemCount": 6
            }
        },
        {
            "id": "PLGt_37JTBZn4",
            "etag": "u8zObpbGJoZ5PUg-ENPqWIfB_Eo",
            "kind": "youtube#playlist",
            "snippet": {
                "title": "I/O Connect Berlin ‘26",
                "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "localized": {
                    "title": "I/O Connect Berlin ‘26",
                    "description": ""
                },
                "thumbnails": {
                    "fhd": {
                        "url": "https://i.ytimg.com/vi/nRLZqaNOrwQ/fhddefault.jpg",
                        "width": 1920,
                        "height": 1080
                    },
                    "high": {
                        "url": "https://i.ytimg.com/vi/nRLZqaNOrwQ/hqdefault.jpg",
                        "width": 480,
                        "height": 360
                    },
                    "maxres": {
                        "url": "https://i.ytimg.com/vi/nRLZqaNOrwQ/maxresdefault.jpg",
                        "width": 1280,
                        "height": 720
                    },
                    "medium": {
                        "url": "https://i.ytimg.com/vi/nRLZqaNOrwQ/mqdefault.jpg",
                        "width": 320,
                        "height": 180
                    },
                    "default": {
                        "url": "https://i.ytimg.com/vi/nRLZqaNOrwQ/default.jpg",
                        "width": 120,
                        "height": 90
                    },
                    "standard": {
                        "url": "https://i.ytimg.com/vi/nRLZqaNOrwQ/sddefault.jpg",
                        "width": 640,
                        "height": 480
                    }
                },
                "description": "",
                "publishedAt": "2026-07-06T18:24:35.642569Z",
                "channelTitle": "Google for Developers"
            },
            "contentDetails": {
                "itemCount": 16
            }
        },
        {
            "id": "PLfBVJoq9fmco",
            "etag": "jh8-TzXx83omSpU714WWsmHBuzM",
            "kind": "youtube#playlist",
            "snippet": {
                "title": "Gemma Playground Series",
                "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "localized": {
                    "title": "Gemma Playground Series",
                    "description": "From running multiple parallel agents on a single laptop to real-world robotics, see what's possible when you bring AI to the edge. The Gemma Playground series showcases the power of the Gemma 4 family running on-device: delivering low latency, privacy, and operating offline without cloud dependencies."
                },
                "thumbnails": {
                    "fhd": {
                        "url": "https://i.ytimg.com/vi/pLwB_63yUBY/fhddefault.jpg",
                        "width": 1920,
                        "height": 1080
                    },
                    "high": {
                        "url": "https://i.ytimg.com/vi/pLwB_63yUBY/hqdefault.jpg",
                        "width": 480,
                        "height": 360
                    },
                    "maxres": {
                        "url": "https://i.ytimg.com/vi/pLwB_63yUBY/maxresdefault.jpg",
                        "width": 1280,
                        "height": 720
                    },
                    "medium": {
                        "url": "https://i.ytimg.com/vi/pLwB_63yUBY/mqdefault.jpg",
                        "width": 320,
                        "height": 180
                    },
                    "default": {
                        "url": "https://i.ytimg.com/vi/pLwB_63yUBY/default.jpg",
                        "width": 120,
                        "height": 90
                    },
                    "standard": {
                        "url": "https://i.ytimg.com/vi/pLwB_63yUBY/sddefault.jpg",
                        "width": 640,
                        "height": 480
                    }
                },
                "description": "From running multiple parallel agents on a single laptop to real-world robotics, see what's possible when you bring AI to the edge. The Gemma Playground series showcases the power of the Gemma 4 family running on-device: delivering low latency, privacy, and operating offline without cloud dependencies.",
                "publishedAt": "2026-06-30T16:51:42.860216Z",
                "channelTitle": "Google for Developers"
            },
            "contentDetails": {
                "itemCount": 6
            }
        },
        {
            "id": "PLOU2XLYxmsIIAOskSyap13n9W-xOt_GP5",
            "etag": "LJUjPRF9aLE-SY_nmnJ_lxjJQ44",
            "kind": "youtube#playlist",
            "snippet": {
                "title": "Google I/O 2026 Keynotes",
                "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "localized": {
                    "title": "Google I/O 2026 Keynotes",
                    "description": "Catch up on the keynote sessions from Google I/O 2026! Learn all about the key announcements from Google I/O and discover the latest updates across the topics of AI, Android, Chrome, and cloud."
                },
                "thumbnails": {
                    "fhd": {
                        "url": "https://i.ytimg.com/vi/wYSncx9zLIU/fhddefault.jpg",
                        "width": 1920,
                        "height": 1080
                    },
                    "high": {
                        "url": "https://i.ytimg.com/vi/wYSncx9zLIU/hqdefault.jpg",
                        "width": 480,
                        "height": 360
                    },
                    "maxres": {
                        "url": "https://i.ytimg.com/vi/wYSncx9zLIU/maxresdefault.jpg",
                        "width": 1280,
                        "height": 720
                    },
                    "medium": {
                        "url": "https://i.ytimg.com/vi/wYSncx9zLIU/mqdefault.jpg",
                        "width": 320,
                        "height": 180
                    },
                    "default": {
                        "url": "https://i.ytimg.com/vi/wYSncx9zLIU/default.jpg",
                        "width": 120,
                        "height": 90
                    },
                    "standard": {
                        "url": "https://i.ytimg.com/vi/wYSncx9zLIU/sddefault.jpg",
                        "width": 640,
                        "height": 480
                    }
                },
                "description": "Catch up on the keynote sessions from Google I/O 2026! Learn all about the key announcements from Google I/O and discover the latest updates across the topics of AI, Android, Chrome, and cloud.",
                "publishedAt": "2026-05-06T18:35:09.810194Z",
                "channelTitle": "Google for Developers"
            },
            "contentDetails": {
                "itemCount": 14
            }
        },
        {
            "id": "PLOU2XLYxmsILVF9qmspC4i4R0t3o64HSx",
            "etag": "l57J0mwB2MNBTu6dgGsRGtqDA7U",
            "kind": "youtube#playlist",
            "snippet": {
                "title": "Google I/O 2026 Recaps",
                "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "localized": {
                    "title": "Google I/O 2026 Recaps",
                    "description": "Catch the highlights from Google I/O 2026! Get the latest innovations, announcements, and exciting moments from the event. Stay up to date with the most important trends and breakthroughs."
                },
                "thumbnails": {
                    "fhd": {
                        "url": "https://i.ytimg.com/vi/aqmpZocmR8o/fhddefault.jpg",
                        "width": 1920,
                        "height": 1080
                    },
                    "high": {
                        "url": "https://i.ytimg.com/vi/aqmpZocmR8o/hqdefault.jpg",
                        "width": 480,
                        "height": 360
                    },
                    "maxres": {
                        "url": "https://i.ytimg.com/vi/aqmpZocmR8o/maxresdefault.jpg",
                        "width": 1280,
                        "height": 720
                    },
                    "medium": {
                        "url": "https://i.ytimg.com/vi/aqmpZocmR8o/mqdefault.jpg",
                        "width": 320,
                        "height": 180
                    },
                    "default": {
                        "url": "https://i.ytimg.com/vi/aqmpZocmR8o/default.jpg",
                        "width": 120,
                        "height": 90
                    },
                    "standard": {
                        "url": "https://i.ytimg.com/vi/aqmpZocmR8o/sddefault.jpg",
                        "width": 640,
                        "height": 480
                    }
                },
                "description": "Catch the highlights from Google I/O 2026! Get the latest innovations, announcements, and exciting moments from the event. Stay up to date with the most important trends and breakthroughs.",
                "publishedAt": "2026-05-06T18:33:33.180951Z",
                "channelTitle": "Google for Developers"
            },
            "contentDetails": {
                "itemCount": 8
            }
        }
    ],
    "pageInfo": {
        "totalResults": 190,
        "resultsPerPage": 5
    },
    "nextPageToken": "CAUQAA"
}

Errors

Status	Meaning	Charged?
401	Missing, invalid or revoked API key	No
402	Not enough credits (`insufficient_credits`)	No
404	The account or post doesn't exist	No
422	Missing or invalid parameters	No
502 / 503	The data source is temporarily unavailable	No

All error codes →

Try it live: Playlists list GET

part

channelId

maxResults

🔒 Preset demo input. Live demos use the Google for Developers channel, youtube.com/@GoogleDevelopers. Sign up free to use your own.

More YouTube endpoints

GET Activities list Read-only YouTube Data API v3 activities list endpoint. /api/v1/youtube/activities 1 credit / call GET Channel sections list Read-only YouTube Data API v3 channelSections list endpoint. /api/v1/youtube/channelSections 1 credit / call GET Channels list Read-only YouTube Data API v3 channels list endpoint. /api/v1/youtube/channels 1 credit / call GET Comment threads list Read-only YouTube Data API v3 commentThreads list endpoint. /api/v1/youtube/commentThreads 1 credit / call GET Comments list Read-only YouTube Data API v3 comments list endpoint. /api/v1/youtube/comments 1 credit / call GET Internationalization languages list Read-only YouTube Data API v3 i18nLanguages list endpoint. /api/v1/youtube/i18nLanguages 1 credit / call