API reference / YouTube / Playlist items list

Playlist items list

Read-only YouTube Data API v3 playlistItems list endpoint.

1 credit per successful call Errors are never charged

Request

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

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 or status. For example: snippet
`playlistId` optional	string	Playlist to list (provide playlistId or id). A channel's uploads playlist is its channel ID with UC replaced by UU. For example: UU_x5XG1OV2P6uZZ5FSM9Ttw
`id` optional	string	Comma-separated playlist item IDs (provide playlistId or id).
`videoId` optional	string	Only return items for this video. For example: OYp5j2RihPE
`maxResults` optional	integer	Maximum results per page (0–50). Default 5.
`pageToken` optional	string	Token from a previous response (nextPageToken or prevPageToken).

Code examples

Example response

{
    "etag": "PHyp00nCMuKE1F_IXw3ycFVzX9Q",
    "kind": "youtube#playlistItemListResponse",
    "items": [
        {
            "id": "VVVfeDVYRzFPVjJQNnVaWjVGU005VHR3Lk9ZcDVqMlJpaFBF",
            "etag": "B8Xg6EI9QUaDLMB-AEeGn69M7Vc",
            "kind": "youtube#playlistItem",
            "snippet": {
                "title": "Gemini 4 Argon and Google Antigravity: From 2D concept to 3D cathedral",
                "position": 0,
                "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "playlistId": "UU_x5XG1OV2P6uZZ5FSM9Ttw",
                "resourceId": {
                    "kind": "youtube#video",
                    "videoId": "OYp5j2RihPE"
                },
                "thumbnails": {
                    "fhd": {
                        "url": "https://i.ytimg.com/vi/OYp5j2RihPE/fhddefault.jpg",
                        "width": 1920,
                        "height": 1080
                    },
                    "high": {
                        "url": "https://i.ytimg.com/vi/OYp5j2RihPE/hqdefault.jpg",
                        "width": 480,
                        "height": 360
                    },
                    "maxres": {
                        "url": "https://i.ytimg.com/vi/OYp5j2RihPE/maxresdefault.jpg",
                        "width": 1280,
                        "height": 720
                    },
                    "medium": {
                        "url": "https://i.ytimg.com/vi/OYp5j2RihPE/mqdefault.jpg",
                        "width": 320,
                        "height": 180
                    },
                    "default": {
                        "url": "https://i.ytimg.com/vi/OYp5j2RihPE/default.jpg",
                        "width": 120,
                        "height": 90
                    },
                    "standard": {
                        "url": "https://i.ytimg.com/vi/OYp5j2RihPE/sddefault.jpg",
                        "width": 640,
                        "height": 480
                    }
                },
                "description": "Watch how an autonomous AI agent takes a flat 2D concept image and reconstructs a photorealistic 3D cathedral in Blender from scratch. Tiago Aragona demonstrates how to connect Antigravity directly to Blender via the Model Context Protocol (MCP), leveraging Gemini 4 Argon across 45 iterative agentic loops to deduce complex architectural geometry, detail column fluting, and set up volumetric lighting.\n\n\n🔗Resources:\nGemini 4 Argon Blog → https://goo.gle/4zze7Rg\nAntigravity Website → https://goo.gle/4B3IxMW\n\n\n\nSubscribe to Google for Developers → https://goo.gle/developers    \n\n\n\nSpeakers: Tiago Aragona\nProducts Mentioned: Gemini 4 Argon, Antigravity, Blender, Model Context Protocol (MCP), Flow",
                "publishedAt": "2026-10-13T19:00:11Z",
                "channelTitle": "Google for Developers",
                "videoOwnerChannelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "videoOwnerChannelTitle": "Google for Developers"
            }
        },
        {
            "id": "VVVfeDVYRzFPVjJQNnVaWjVGU005VHR3LklCVm1lbk9yb1Bz",
            "etag": "GtTnX1fUw220zeBFioVg9Cn-y6Q",
            "kind": "youtube#playlistItem",
            "snippet": {
                "title": "Order in any language with Gemini 3.5 Live Translate",
                "position": 1,
                "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "playlistId": "UU_x5XG1OV2P6uZZ5FSM9Ttw",
                "resourceId": {
                    "kind": "youtube#video",
                    "videoId": "IBVmenOroPs"
                },
                "thumbnails": {
                    "high": {
                        "url": "https://i.ytimg.com/vi/IBVmenOroPs/hqdefault.jpg",
                        "width": 480,
                        "height": 360
                    },
                    "maxres": {
                        "url": "https://i.ytimg.com/vi/IBVmenOroPs/maxresdefault.jpg",
                        "width": 1280,
                        "height": 720
                    },
                    "medium": {
                        "url": "https://i.ytimg.com/vi/IBVmenOroPs/mqdefault.jpg",
                        "width": 320,
                        "height": 180
                    },
                    "default": {
                        "url": "https://i.ytimg.com/vi/IBVmenOroPs/default.jpg",
                        "width": 120,
                        "height": 90
                    },
                    "standard": {
                        "url": "https://i.ytimg.com/vi/IBVmenOroPs/sddefault.jpg",
                        "width": 640,
                        "height": 480
                    }
                },
                "description": "See how Gemini 3.5 Live Translate and Gemini 3.5 Transcribe work together to help an English speaker place a sushi order with a Japanese-speaking host, translating the conversation in real time.\n\nTry it now at Google AI Studio. Have questions? Drop them in the comments.\n\n\n🔗Resources:\nBlog  → https://goo.gle/4jbKjoM\nDeveloper documentation → https://goo.gle/3TPrgWR\n\n\nSubscribe to Google for Developers → https://goo.gle/developers    \n\n\n\nSpeakers: Sam Goldstein \nProducts Mentioned: Gemini",
                "publishedAt": "2026-10-09T23:00:24Z",
                "channelTitle": "Google for Developers",
                "videoOwnerChannelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "videoOwnerChannelTitle": "Google for Developers"
            }
        },
        {
            "id": "VVVfeDVYRzFPVjJQNnVaWjVGU005VHR3LmZNZ2NtOWFYWnlZ",
            "etag": "bzvD1fvCT8R8sTzfrILrc_gMQWg",
            "kind": "youtube#playlistItem",
            "snippet": {
                "title": "🤖 Operating real hardware with Gemini AI",
                "position": 2,
                "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "playlistId": "UU_x5XG1OV2P6uZZ5FSM9Ttw",
                "resourceId": {
                    "kind": "youtube#video",
                    "videoId": "fMgcm9aXZyY"
                },
                "thumbnails": {
                    "high": {
                        "url": "https://i.ytimg.com/vi/fMgcm9aXZyY/hqdefault.jpg",
                        "width": 480,
                        "height": 360
                    },
                    "maxres": {
                        "url": "https://i.ytimg.com/vi/fMgcm9aXZyY/maxresdefault.jpg",
                        "width": 1280,
                        "height": 720
                    },
                    "medium": {
                        "url": "https://i.ytimg.com/vi/fMgcm9aXZyY/mqdefault.jpg",
                        "width": 320,
                        "height": 180
                    },
                    "default": {
                        "url": "https://i.ytimg.com/vi/fMgcm9aXZyY/default.jpg",
                        "width": 120,
                        "height": 90
                    },
                    "standard": {
                        "url": "https://i.ytimg.com/vi/fMgcm9aXZyY/sddefault.jpg",
                        "width": 640,
                        "height": 480
                    }
                },
                "description": "When your friend has a robot arm in another state, you find a way to use it. Watch how Matías and David used Gemini to bridge 1,700 miles, building custom 3D web controllers that operate physical hardware in real time. \n\n🔗 Explore the build → https://goo.gle/3U909Gu\n\n\nSubscribe to Google for Developers → https://goo.gle/developers   \n\n\nProducts Mentioned: Gemini, Google Antigravity, Google AI Studio\nSpeakers: Matías Piña Aguilera, David Maliglowka",
                "publishedAt": "2026-10-09T19:00:36Z",
                "channelTitle": "Google for Developers",
                "videoOwnerChannelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "videoOwnerChannelTitle": "Google for Developers"
            }
        },
        {
            "id": "VVVfeDVYRzFPVjJQNnVaWjVGU005VHR3LjdzS0hpdUU3Si1Z",
            "etag": "gyKGVa3mP0xhVDXK6tk4B2q2mFY",
            "kind": "youtube#playlistItem",
            "snippet": {
                "title": "Building low-latency remote robotics with Gemini",
                "position": 3,
                "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "playlistId": "UU_x5XG1OV2P6uZZ5FSM9Ttw",
                "resourceId": {
                    "kind": "youtube#video",
                    "videoId": "7sKHiuE7J-Y"
                },
                "thumbnails": {
                    "fhd": {
                        "url": "https://i.ytimg.com/vi/7sKHiuE7J-Y/fhddefault.jpg",
                        "width": 1920,
                        "height": 1080
                    },
                    "high": {
                        "url": "https://i.ytimg.com/vi/7sKHiuE7J-Y/hqdefault.jpg",
                        "width": 480,
                        "height": 360
                    },
                    "maxres": {
                        "url": "https://i.ytimg.com/vi/7sKHiuE7J-Y/maxresdefault.jpg",
                        "width": 1280,
                        "height": 720
                    },
                    "medium": {
                        "url": "https://i.ytimg.com/vi/7sKHiuE7J-Y/mqdefault.jpg",
                        "width": 320,
                        "height": 180
                    },
                    "default": {
                        "url": "https://i.ytimg.com/vi/7sKHiuE7J-Y/default.jpg",
                        "width": 120,
                        "height": 90
                    },
                    "standard": {
                        "url": "https://i.ytimg.com/vi/7sKHiuE7J-Y/sddefault.jpg",
                        "width": 640,
                        "height": 480
                    }
                },
                "description": "Working 1,700 miles apart, Matías and David used Google Antigravity, Google AI Studio, and Gemini to construct a remote robotics framework powered by custom 3D web controllers.\n\nWatch to discover how they implemented low-latency hardware controls to operate physical machinery across thousands of miles.\n\nTry building today → https://goo.gle/4ya3rr3\n\n\nSubscribe to Google for Developers → https://goo.gle/developers   \n\n\nProducts Mentioned: Gemini, Google Antigravity, Google AI Studio\nSpeakers: Matías Piña Aguilera, David Maliglowka",
                "publishedAt": "2026-10-09T16:00:10Z",
                "channelTitle": "Google for Developers",
                "videoOwnerChannelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "videoOwnerChannelTitle": "Google for Developers"
            }
        },
        {
            "id": "VVVfeDVYRzFPVjJQNnVaWjVGU005VHR3LmZMOU9CSk8zR3U4",
            "etag": "TG4gLy31tNu3VkTM2XAvfbvh694",
            "kind": "youtube#playlistItem",
            "snippet": {
                "title": "Building with Gemma 4",
                "position": 4,
                "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "playlistId": "UU_x5XG1OV2P6uZZ5FSM9Ttw",
                "resourceId": {
                    "kind": "youtube#video",
                    "videoId": "fL9OBJO3Gu8"
                },
                "thumbnails": {
                    "qhd": {
                        "url": "https://i.ytimg.com/vi/fL9OBJO3Gu8/qhddefault.jpg",
                        "width": 2560,
                        "height": 1440
                    },
                    "high": {
                        "url": "https://i.ytimg.com/vi/fL9OBJO3Gu8/hqdefault.jpg",
                        "width": 480,
                        "height": 360
                    },
                    "maxres": {
                        "url": "https://i.ytimg.com/vi/fL9OBJO3Gu8/maxresdefault.jpg",
                        "width": 1280,
                        "height": 720
                    },
                    "medium": {
                        "url": "https://i.ytimg.com/vi/fL9OBJO3Gu8/mqdefault.jpg",
                        "width": 320,
                        "height": 180
                    },
                    "default": {
                        "url": "https://i.ytimg.com/vi/fL9OBJO3Gu8/default.jpg",
                        "width": 120,
                        "height": 90
                    },
                    "standard": {
                        "url": "https://i.ytimg.com/vi/fL9OBJO3Gu8/sddefault.jpg",
                        "width": 640,
                        "height": 480
                    }
                },
                "description": "Gemma 4 is the most capable model family you can run on your hardware. They complement our Gemini models, giving our developer community the industry's most powerful combination of both open and proprietary tools. Watch for inspiration for your next Gemma build, or even just to get to know Reachy the offline robot (running LFG-3 on a Reachy Mini and NVIDIA DGX Spark). \n\nLearn more about Gemma here: https://goo.gle/4dxj30m, and share what you’ll build with an AI model that runs directly on-device in the comments below! \n\n\n🔗Resources:\n\nCommunity Builds Featured in this Video \n*Wearable Robotic Arm →  https://goo.gle/4rVOib9\n*PenguinAgent → https://goo.gle/3VVfTNO\n*CodeBuddy (Offline Coding) → https://goo.gle/4y9tRsM\n\nModels & Open Source Attributions\n*Custom Model: LFG-3 → https://goo.gle/3UbydBQ\n*Speech Recognition: LFG-3 fuses NVIDIA Parakeet → https://goo.gle/3TTzn4T, licensed under CC BY 4.0 → https://goo.gle/4ic5Tby \n*Text-to-Speech: This project uses Kyutai TTS 1.6B → https://goo.gle/4hBVrtR, licensed under CC BY 4.0 → https://goo.gle/4ic5Tby\n\n\nSubscribe to Google for Developers → https://goo.gle/developers    \n\n\n\nSpeakers: Glenn Cameron\nProducts Mentioned: Gemma",
                "publishedAt": "2026-10-08T23:00:09Z",
                "channelTitle": "Google for Developers",
                "videoOwnerChannelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "videoOwnerChannelTitle": "Google for Developers"
            }
        }
    ],
    "pageInfo": {
        "totalResults": 6112,
        "resultsPerPage": 5
    },
    "nextPageToken": "EAAaHlBUOkNBVWlFRFkwTlRnM09FUXhOVFZHUVVNMlF6QQ"
}

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: Playlist items list GET

part

maxResults

playlistId

🔒 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