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 to retrieve the latest episodes from specified podcasts. It is designed to fetch detailed information about the most recent episodes of one or more podcasts by their unique identifiers (UUIDs). This node is useful for podcast app developers, content aggregators, or anyone needing up-to-date episode data from multiple podcasts in an automated workflow.

Practical examples include:

  • Automatically updating a podcast directory with the newest episodes.
  • Triggering notifications or social media posts when new episodes are released.
  • Aggregating episode metadata for analytics or recommendation engines.

Properties

Name Meaning
Podcast UUIDs Comma-separated list of podcast UUIDs to get the latest episodes from. Example: uuid1,uuid2,uuid3.
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.

Output

The output is a JSON array where each item corresponds to a latest episode retrieved for the requested podcasts. Each JSON object includes the selected response fields as specified in the input properties. The fields provide detailed metadata about the episode and its parent podcast, such as:

  • Unique identifier (UUID)
  • Episode title or name
  • Description or summary
  • Direct audio URL for playback
  • Publication date
  • Duration of the episode
  • Episode and season numbers
  • Website URL related to the episode or podcast
  • Podcast-level description and image URL

No binary data output is indicated by the source code.

Dependencies

  • Requires an API key credential for authenticating with the Taddy Podcast API.
  • The node makes HTTP requests to https://api.taddy.org.
  • Proper configuration of the API key credential within n8n is necessary for successful operation.

Troubleshooting

  • Common issues:

    • Invalid or missing podcast UUIDs will result in errors or empty responses.
    • Incorrect or expired API credentials will cause authentication failures.
    • Network connectivity problems can prevent access to the Taddy API endpoint.

  • Error messages:

    • "Unknown operation: latest.getLatest": Indicates that the specified resource-operation combination is not implemented or misspelled.
    • API error messages returned from the Taddy service will be passed through; these often relate to invalid parameters or authentication issues.

  • Resolutions:

    • Verify that the podcast UUIDs are correct and properly formatted.
    • Ensure the API key credential is valid and has appropriate permissions.
    • Check network settings and firewall rules to allow outbound HTTPS requests to api.taddy.org.

Links and References

Discussion