List Playlist Items
youtube_list_playlist_itemsRead-onlyIdempotent
Retrieve videos inside a YouTube playlist with pagination support. Use playlist ID to get items, optionally paginate with pageToken.
Instructions
List the videos inside a playlist, with pagination support.
Args
playlistId(string, required): Playlist ID to list items from.maxResults(integer 1–50, default 25): Items per page.pageToken(string, optional): Pagination cursor from a previous call'snextPageToken.response_format("markdown" | "json", default "markdown"): Output format.
Returns JSON shape:
{
"playlistId": "PL...",
"items": [
{
"playlistItemId": "PLitem...",
"position": 0,
"videoId": "dQw4w9WgXcQ",
"title": "Video Title",
"description": "...",
"publishedAt": "2024-01-01T00:00:00Z",
"videoOwnerChannelTitle": "Channel Name"
}
],
"nextPageToken": "...",
"totalResults": 50
}Examples
youtube_list_playlist_items({ playlistId: "PL..." })Next page:
youtube_list_playlist_items({ playlistId: "PL...", pageToken: "..." })
Errors
404 → playlist not found.
403 → no access.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| playlistId | Yes | Playlist ID whose items to list. | |
| maxResults | No | Items per page (1–50, default 25). | |
| pageToken | No | Pagination cursor from a previous call. | |
| response_format | No | Output format: "markdown" (default) or "json". | markdown |