Supadata

Access Supadata API to fetch YouTube and web data

Actions7

Overview

This node integrates with the Supadata API to fetch data related to YouTube playlists and their videos. Specifically, for the "Get Playlist Videos" operation, it retrieves a list of video IDs from a specified YouTube playlist. This is useful when you want to programmatically access all or a subset of videos within a playlist for further processing, such as analysis, downloading metadata, or feeding into other workflows.

Practical examples:

  • Automatically gather all video IDs from a curated playlist to generate reports or summaries.
  • Use the retrieved video IDs to fetch detailed video information in subsequent workflow steps.
  • Monitor new additions to a playlist by periodically fetching its videos.

Properties

Name Meaning
Playlist The ID or full URL of the YouTube playlist from which to retrieve videos.
Limit Maximum number of video results to return (between 1 and 5000). Limits how many videos are fetched.

Output

The output is a JSON array where each item corresponds to a video ID string from the specified playlist. The key field in each JSON object is typically the video ID itself (e.g., "videoId": "abc123xyz"), but based on the code, the raw array of video IDs is returned and then wrapped into JSON objects by n8n's helper functions.

No binary data is output by this operation.

Example output structure:

[
  { "videoId": "Xyz123Abc" },
  { "videoId": "Def456Ghi" },
  ...
]

Dependencies

  • Requires an active connection to the Supadata API via an API key credential configured in n8n.
  • The node depends on the Supadata service to handle YouTube API requests internally.
  • No direct YouTube API credentials are needed since Supadata acts as a proxy.

Troubleshooting

  • Common issues:

    • Invalid or malformed playlist ID or URL: Ensure the playlist identifier is correct and properly formatted.
    • Exceeding the limit parameter: The maximum allowed is 5000; setting higher values may cause errors.
    • Network or API errors from Supadata: Check your API key validity and network connectivity.

  • Error messages:

    • "error": "Invalid playlist ID" — Verify the playlist ID or URL input.
    • "error": "API rate limit exceeded" — Wait and retry later or check your API usage limits.
    • "error": "Unauthorized" — Confirm that the API key credential is correctly set up and has permissions.

Links and References

Discussion