YouTube Activities List
1 credits/call
ae_youtube_activities_list
List recent activities for a YouTube channel, such as new uploads, likes, or playlist updates.
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 |
|---|---|---|---|---|
home | boolean | No | If true, returns the authenticated user's home activity feed. Requires authentication. | — |
mine | boolean | No | If true, returns only resources owned by the currently authenticated user. | — |
part | string | Yes | Required. Comma-separated list of one or more resource parts: id, snippet, contentDetails. Example: snippet,contentDetails. Use only these part names. | — |
channelId | string | No | The YouTube channel ID to filter results by. Only returns resources belonging to this channel. | — |
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. Official documentation lists 0 to 50, but direct API tests returned 100, 101 and 200 items for those requested page sizes. The actual runtime maximum has not been established. Zero may still return one item. | — |
regionCode | string | No | ISO 3166-1 alpha-2 country code to filter content availability (e.g., 'US', 'CN'). | — |
publishedAfter | string | No | Only include resources published after this timestamp. Format: RFC 3339 (e.g., 2024-01-01T00:00:00Z). | — |
publishedBefore | string | No | Only include resources published before this timestamp. Format: RFC 3339 (e.g., 2024-12-31T23:59:59Z). | — |
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_activities_list' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"channelId": "UCQ4FNww3XoNgqIlkBqEAVCg",
"maxResults": 3,
"part": "snippet",
"publishedAfter": "2026-07-01T00:00:00Z"
}
}'Response exampleresponse.json
{
"etag": "NP6kYsWYR7M1WizjVnk256KOTRQ",
"items": [
{
"etag": "bDmo80G_5sbfnMktGeA3I1lOpZU",
"id": "MTUxNzg3NzYwNjg2MTc4Nzc2MDY4NjAwMDkzNw",
"kind": "youtube#activity",
"snippet": {
"channelId": "UCQ4FNww3XoNgqIlkBqEAVCg",
"channelTitle": "Iman Gadzhi",
"description": "Next, watch this video where I break down the best AI business model to start and make $10k+/month: https://youtu.be/pPpb4t2eV2M",
"publishedAt": "2026-08-26T16:11:26+00:00",
"title": "You're Not Late (Yet): Learn 98% of Gemini in Under 26 Minutes",
"type": "upload"
}
}
],
"kind": "youtube#activityListResponse",
"nextPageToken": "CAMQAA",
"pageInfo": {
"resultsPerPage": 3,
"totalResults": 13
}
}This example shows part of the response. Copied content is valid JSON.

