YouTube Playlistitems List
1 credits/call
ae_youtube_playlistitems_list
List the videos and other items in a YouTube playlist.
1 credits/call
Pricing
1 credits/call
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
id | string | No | Unique identifier of the resource to retrieve or operate on. | — |
part | string | Yes | The *part* parameter specifies a comma-separated list of one or more playlistItem resource properties that the API response will include. If the parameter identifies a property that contains child properties, the child properties will be included in the response. For example, in a playlistItem resource, the snippet property contains numerous fields, including the title, description, position, and resourceId properties. As such, if you set *part=snippet*, the API response will contain all of those properties. | — |
videoId | string | No | Return the playlist items associated with the given video ID. | — |
pageToken | string | No | Optional opaque pagination token. Omit on the first request. To fetch the next page, copy nextPageToken exactly from the previous response into pageToken and call this same endpoint again, keeping the playlist/channel/video identifiers, filters, part and other query settings unchanged. Use prevPageToken to go back when provided. Do not invent tokens or use a token from another query. Stop when nextPageToken is absent; no nextPageToken means no further page is advertised, even if a page contains fewer items than maxResults. | — |
maxResults | integer | No | Maximum number of items requested per page, not a limit on the total query results. Use nextPageToken as pageToken to retrieve subsequent pages when available. Direct API tests accepted values above 50 but capped the effective page size at 50; requesting more does not increase page size. Zero is accepted and can return an empty page. | — |
playlistId | string | No | YouTube playlist ID. Use a supplied valid playlist ID, playlists.list items[].id, or search.list(type=playlist) items[].id.playlistId. For a channel uploads playlist, call channels.list(part=contentDetails) and use items[].contentDetails.relatedPlaylists.uploads. Do not use a channel ID or video ID as playlistId. | — |
onBehalfOfContentOwner | string | No | *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner. | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_youtube_playlistitems_list' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"fields": "items(contentDetails)",
"maxResults": 2,
"part": "contentDetails",
"playlistId": "UUadu90TWeXp9EAuiRAIDYhg",
"prettyPrint": false
}
}'Response exampleresponse.json
{
"items": [
{
"contentDetails": {
"videoId": "FA9E-eqI92Q",
"videoPublishedAt": "2026-10-29T07:03:11Z"
}
}
]
}This example shows part of the response. Copied content is valid JSON.
Guides using this tool
See how this tool fits into real workflows

