Taddy API icon

Taddy API

Interact with Taddy Podcast API - Search 4M+ podcasts and 180M+ episodes

Actions8

Overview

The node interacts with the Taddy Podcast API, enabling users to retrieve detailed information about podcast episodes. Specifically, the "Episode - Get" operation allows fetching metadata and optionally transcript and chapter data for a single episode identified by UUID, GUID, or name.

This node is beneficial in scenarios where you want to enrich workflows with podcast episode details, such as:

  • Displaying episode metadata in content management systems.
  • Automating podcast analytics or reporting.
  • Integrating episode transcripts or chapters into other applications.

For example, you could use this node to fetch an episode's description, audio URL, and publication date by providing its UUID, then use that data downstream to generate social media posts or update a website.

Properties

Name Meaning
Identifier Type How to identify the episode. Options: UUID, GUID, or Name.
Identifier Value The actual identifier value (UUID, GUID, or episode name) used to look up the episode.
Response Fields Select which fields to include in the response. Options include: UUID, Name/Title, Description, Audio URL, Date Published, Duration, Episode Number, Season Number, Website URL, Podcast Description, Podcast Image URL, iTunes ID, RSS URL.
Include Transcript Whether to include the episode's transcript data in the response (true or false).
Include Chapters Whether to include the episode's chapter data in the response (true or false).

Output

The output is a JSON object containing the requested episode details based on the selected response fields. The structure includes standard metadata such as identifiers, titles, descriptions, URLs, dates, and numbers related to the episode and its podcast.

If enabled, the output also includes:

  • Transcript data: The full text or structured transcript of the episode.
  • Chapter data: Information about chapters within the episode, such as timestamps and titles.

No binary data output is indicated for this operation.

Example output snippet (simplified):

{
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Episode Title",
  "description": "Summary of the episode",
  "audioUrl": "https://example.com/audio.mp3",
  "datePublished": "2023-01-01T00:00:00Z",
  "duration": 3600,
  "episodeNumber": 5,
  "seasonNumber": 1,
  "websiteUrl": "https://podcastwebsite.com",
  "podcastDescription": "Description of the podcast",
  "podcastImageUrl": "https://example.com/image.jpg",
  "itunesId": "987654321",
  "rssUrl": "https://podcastrss.com/feed.xml",
  "transcript": "...",         // if included
  "chapters": [ ... ]          // if included
}

Dependencies

  • Requires an API key credential for authenticating with the Taddy Podcast API.
  • The node makes HTTP requests to https://api.taddy.org.
  • No additional environment variables are explicitly required beyond the API key credential configuration.

Troubleshooting

  • Common issues:

    • Providing an invalid or missing episode identifier will result in errors or empty responses.
    • Selecting no response fields may return minimal or no data.
    • Network connectivity issues can cause request failures.

  • Error messages:

    • "Unknown operation: episode.getDetails": Indicates the operation name is incorrect or not implemented; verify the operation parameter.
    • API authentication errors: Ensure the API key credential is correctly configured and valid.
    • "Episode not found" or similar: Check that the identifier type matches the identifier value and that the episode exists.

  • Resolutions:

    • Double-check input parameters for correctness.
    • Confirm API credentials are set up properly.
    • Enable "Continue On Fail" in the node settings to handle errors gracefully during batch processing.

Links and References

  • Taddy Podcast API Documentation (hypothetical link, replace with actual if available)
  • n8n Documentation on Creating Custom Nodes
  • General info on podcast metadata standards (e.g., RSS, iTunes tags) for understanding fields like episode number and season number.

Discussion