Supadata

Access Supadata API to fetch YouTube and web data

Actions7

Overview

The Supadata n8n node, when configured with the YouTube resource and the Get Transcript operation, retrieves the transcript (captions/subtitles) of a specified YouTube video. This is useful for automating workflows that require access to the spoken content of YouTube videos, such as:

  • Generating searchable text from video content.
  • Creating summaries or analyses of video material.
  • Archiving transcripts for compliance or accessibility purposes.

Practical Example:
Automatically fetch the transcript of a training video and send it to a language model for summarization, or store it in a database for later reference.

Properties

Name Type Meaning
Video String The ID or URL of the YouTube video whose transcript you want to retrieve.
Return as Plain Text Boolean Whether to return the transcript as plain text (true) or as structured data (false).

Output

  • The output will be a JSON object containing the transcript of the specified YouTube video.
  • If Return as Plain Text is enabled, the transcript will be returned as a single plain text string.
  • If not, the transcript may be returned as a structured array (e.g., with timestamps and text segments).

Example Output (Plain Text):

{
  "transcript": "This is the full transcript of the video..."
}

Example Output (Structured):

{
  "transcript": [
    {"start": 0, "end": 5, "text": "Welcome to the video."},
    {"start": 6, "end": 10, "text": "Let's get started."}
  ]
}

Note: The exact structure depends on the API response.

Dependencies

  • Supadata API: Requires valid credentials for the Supadata API (configured in n8n as supadataApi).
  • YouTube Video: The video must have captions/transcripts available.
  • No additional environment variables are required beyond standard n8n credential setup.

Troubleshooting

Common Issues:

  • Invalid Video ID/URL: If the provided video identifier is incorrect or malformed, the node will fail to retrieve the transcript.
  • No Transcript Available: Some YouTube videos do not have transcripts/captions; in this case, the output may be empty or an error message will be returned.
  • Authentication Errors: If the Supadata API credentials are missing or invalid, the node will throw an authentication error.

Error Messages & Resolutions:

  • "Video not found": Check that the Video property contains a valid YouTube video ID or URL.
  • "Transcript not available": Ensure the target video has captions enabled.
  • "Invalid credentials": Verify your Supadata API credentials in n8n.

Links and References

Discussion