Actions7
- YouTube Actions
- Web Actions
Overview
This node retrieves videos from a specified YouTube playlist using the Supadata API. It is useful for workflows that need to process, analyze, or archive lists of videos from public or private YouTube playlists. Common scenarios include content aggregation, playlist analytics, or automated video processing pipelines.
Example use cases:
- Fetching all videos from a training playlist for further analysis.
- Archiving metadata of videos in a marketing campaign playlist.
- Triggering downstream automation (e.g., notifications) when new videos are added to a playlist.
Properties
Name | Type | Meaning |
---|---|---|
Playlist | String | The ID or URL of the YouTube playlist from which to fetch videos. |
Limit | Number | Maximum number of videos to return (between 1 and 5000). |
Output
The output is a JSON array where each item represents a video from the specified playlist. Each object in the array contains information about a single video. The exact structure depends on the Supadata API response, but typically includes fields such as:
[
{
"videoId": "string",
"title": "string",
"description": "string",
"publishedAt": "string",
// ...other video metadata fields
}
]
If an error occurs and "Continue On Fail" is enabled, the output will contain an error
field with the error message.
Dependencies
- Supadata API: Requires valid credentials configured in n8n under the name
supadataApi
. - Internet Access: The node must be able to reach the Supadata API endpoint.
Troubleshooting
Common issues:
- Invalid Playlist ID/URL: If the provided playlist identifier is incorrect or inaccessible, the node may return an error such as
"Playlist not found"
or"Invalid playlist ID"
. Double-check the input value. - API Authentication Errors: If credentials are missing or invalid, you may see errors like
"Authentication failed"
or"Missing API key"
. Ensure your Supadata API credentials are correctly set up in n8n. - Limit Exceeded: If you specify a limit outside the allowed range (1–5000), the node may throw a validation error. Adjust the limit accordingly.
Error Handling:
- If "Continue On Fail" is enabled, errors for individual items will be returned in the output with an
error
property instead of stopping the workflow.
Links and References
- YouTube Playlists Documentation
- n8n Credentials Documentation
- Supadata API documentation (refer to your Supadata provider for details)