Podcast Data Extractor (Taddy API)

Interact with the Taddy Podcast API
Join our community

Actions4

Overview

The node "Podcast Data Extractor (Taddy API)" interacts with the Taddy Podcast API to retrieve various podcast-related data. Specifically, for the Get Podcast Episodes operation, it fetches episodes of a specified podcast by its UUID. This is useful when you want to list or process episodes from a particular podcast series, such as displaying episode details in an app, analyzing episode metadata, or preparing episode lists for further automation.

Practical examples include:

  • Fetching the latest episodes of a favorite podcast to display on a website.
  • Automating content curation workflows by retrieving episode metadata.
  • Integrating podcast episode data into other systems like CRMs or newsletters.

Properties

Name Meaning
Podcast UUID The unique identifier (UUID) of the podcast whose episodes you want to retrieve.
Max Results Maximum number of episode results to return. This limits the number of episodes fetched.

Output

The output JSON contains the following structure for the Get Podcast Episodes operation:

  • operation: The string "getPodcastEpisodes".
  • podcastUuid: The UUID of the requested podcast.
  • podcastName: The name of the podcast series.
  • episodes: An array of episode objects, each containing:
    • uuid: Episode UUID.
    • name: Episode title.
    • description: Description of the episode.
    • audioUrl: URL to the episode's audio file.
    • duration: Length of the episode (likely in seconds).
    • episodeNumber: Episode number within the series.
    • seasonNumber: Season number if applicable.
    • transcriptUrls: URLs to transcripts if available.
    • imageUrl: Image associated with the episode.
    • fileType: Audio file type/format.
  • totalEpisodes: Total number of episodes available in the podcast.
  • returned: Number of episodes returned (limited by Max Results).

No binary data output is indicated for this operation.

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) is necessary.
  • No additional environment variables are required beyond the API credentials.

Troubleshooting

  • Missing Podcast UUID: The operation requires a valid podcast UUID. If omitted or invalid, the node throws an error indicating that the Podcast UUID is required.
  • API Errors: Errors from the Taddy API (e.g., bad requests, authentication failures) will be surfaced with detailed messages including HTTP status codes and response bodies.
  • Rate Limits or Quotas: If the API enforces usage limits, exceeding them may cause errors; users should monitor their API credit usage.
  • Empty Results: If the podcast has no episodes or the UUID is incorrect, the episodes array may be empty.
  • Max Results Handling: The node applies client-side slicing to limit results; setting Max Results too high may impact performance or API response times.

To resolve common issues:

  • Ensure the Podcast UUID is correctly copied from prior search or retrieval operations.
  • Verify API credentials are valid and have sufficient permissions.
  • Check network connectivity and API endpoint availability.
  • Use the "Check API Credits" operation to monitor remaining transcript credits if relevant.

Links and References

Discussion