Podcast Data Extractor (Taddy API)

Interact with the Taddy Podcast API
Join our community

Actions4

Overview

The Podcast Data Extractor (Taddy API) node allows users to interact with the Taddy Podcast API to retrieve various podcast-related data. Specifically, the Get Episode Transcript operation extracts the transcript of a specific podcast episode by its UUID.

This node is beneficial in scenarios where you want to:

  • Obtain the full transcript text of a podcast episode for content analysis, search indexing, or accessibility purposes.
  • Automate the retrieval of episode transcripts for further processing such as sentiment analysis, summarization, or keyword extraction.
  • Integrate podcast transcripts into other workflows or applications without manual copy-pasting.

Example use case:
You have a list of podcast episodes and want to automatically fetch their transcripts to create searchable text archives or generate show notes.

Properties

Name Meaning
Episode UUID UUID of the episode (from episode results). This uniquely identifies the episode whose transcript you want to retrieve.

Output

The output JSON contains the following fields:

  • operation: The operation performed, here it will be "getTranscript".
  • episodeUuid: The UUID of the requested episode.
  • episodeName: The name/title of the episode.
  • transcript: An array of transcript segments (strings).
  • transcriptSegments: Number of transcript segments returned.
  • transcriptText: The full transcript as a single string, joining all segments with line breaks.

The node does not output binary data; all transcript data is provided as structured JSON text.

Dependencies

  • Requires an API key credential for the Taddy Podcast API.
  • The node makes HTTP POST requests to the Taddy API GraphQL endpoint (https://api.taddy.org/graphql).
  • Proper configuration of the API credentials (user ID and API key) within n8n is necessary.

Troubleshooting

  • Missing Episode UUID: If the "Episode UUID" property is empty or invalid, the node throws an error indicating that the episode UUID is required.
  • API Errors: Errors from the Taddy API (e.g., invalid credentials, rate limits, or malformed queries) are caught and reported with details including status code and response body.
  • Transcript Not Available: If the episode has no transcript, the transcript array may be empty, and transcriptText will be an empty string.
  • Network Issues: Connectivity problems to the Taddy API endpoint will cause request failures; ensure network access and valid credentials.

To resolve errors:

  • Verify the episode UUID is correct and corresponds to an existing episode.
  • Check that your API credentials are valid and have sufficient permissions/credits.
  • Review the error message details returned by the node for clues on what went wrong.

Links and References

Discussion