Podcast Data Extractor (Taddy API)

Interact with the Taddy Podcast API
Join our community

Actions4

Overview

The node "Podcast Data Extractor (Taddy API)" allows users to interact with the Taddy Podcast API to retrieve detailed podcast-related data. It supports multiple operations such as checking transcript credits, searching podcasts and episodes, retrieving known popular podcasts, fetching detailed information about a specific podcast by its UUID, getting episodes of a podcast, and extracting transcripts from specific episodes.

This node is beneficial in scenarios where you want to automate podcast data retrieval for analysis, content aggregation, or enrichment workflows. For example, you could use it to:

  • Search for podcasts on a particular topic and gather metadata.
  • Retrieve detailed information about a podcast series using its unique identifier.
  • Fetch episode lists for a podcast to display or process further.
  • Extract transcripts from episodes for text analysis or accessibility purposes.
  • Monitor remaining transcript extraction credits to manage usage limits.

Properties

Name Meaning
Operation The action to perform. Options include: Check API Credits, Get Episode Transcript, Get Known Podcasts, Get Podcast by UUID, Get Podcast Episodes, Search Podcasts.
Search Query Term used to search for podcasts (used only in Search Podcasts operation).
Max Results Maximum number of results to return (applies to Search Podcasts and Get Podcast Episodes).
Advanced Options Additional filters for searching podcasts, including content types, genres, languages, match strategy, published after date, transcript availability, and sort order.
Podcast UUID Unique identifier of the podcast (required for Get Podcast by UUID and Get Podcast Episodes operations).
Episode UUID Unique identifier of the episode (required for Get Episode Transcript operation).

Details for "Podcast UUID" property (relevant to your request)

Name Meaning
Podcast UUID UUID of the podcast (from search results)

Output

The output JSON structure varies depending on the selected operation:

  • Get Podcast by UUID: Returns detailed information about the podcast series, including:

    • uuid: Podcast unique identifier
    • name: Podcast name
    • itunesId: iTunes identifier
    • description: Podcast description
    • imageUrl: URL to podcast artwork
    • rssUrl: RSS feed URL
    • language: Language of the podcast
    • totalEpisodesCount: Number of episodes
    • authorName: Author or creator name
    • websiteUrl: Official website URL
    • itunesInfo: Additional iTunes-specific info like summary and artwork
    • genres: List of genres associated with the podcast

  • Other operations produce outputs relevant to their function, such as transcript credits count, search results with podcast and episode metadata, episode lists with details, or episode transcripts.

If binary data were returned (e.g., audio files), it would be summarized accordingly; however, this node returns only JSON data related to podcasts and transcripts.

Dependencies

  • Requires an API key credential for the Taddy Podcast API, which must be configured in n8n credentials.
  • Uses HTTP POST requests to the Taddy API GraphQL endpoint (https://api.taddy.org).
  • No additional external dependencies are required beyond the configured API authentication.

Troubleshooting

  • Missing Required Parameters: Operations like "Get Podcast by UUID" require the podcastUuid parameter. Omitting it will cause an error indicating the missing input.
  • API Errors: If the Taddy API returns errors (e.g., invalid queries, rate limits), the node throws an error with details including status code and response body. To resolve, verify API credentials, check query parameters, and ensure usage limits are not exceeded.
  • Empty Results: Searches or lookups may return empty results if no matching podcasts or episodes exist. Adjust search terms or filters accordingly.
  • Network Issues: Connectivity problems can cause request failures. Ensure network access to the Taddy API endpoint.
  • Continue On Fail: If enabled, the node will output error details per item instead of stopping execution, useful for bulk processing.

Links and References

If you need details on other operations or properties, feel free to ask!

Discussion