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 podcasts. Specifically, for the "Podcast" resource and "Get" operation, it fetches podcast details based on various identifier types such as UUID, name, iTunes ID, or RSS URL. Users can customize which podcast fields to include in the response and optionally include episode data with selectable episode fields.

This node is beneficial when you want to enrich your workflows with comprehensive podcast metadata or episode information, for example:

  • Building a podcast discovery app that shows detailed podcast info.
  • Aggregating podcast data for analytics or content curation.
  • Fetching episodes of a specific podcast for further processing or distribution.

Properties

Name Meaning
Identifier Type How to identify the podcast. Options: UUID, Name, iTunes ID, RSS URL.
Identifier Value The actual identifier value corresponding to the chosen Identifier Type (e.g., the UUID string, podcast name, iTunes ID number, or RSS feed URL).
Response Fields Which podcast fields to include in the response. Options include UUID, Name/Title, Description, Image URL, iTunes ID, Language, Popularity Rank, RSS URL, Total Episodes Count, Website URL, Countries, Genres.
Include Episodes Boolean flag indicating whether to include episodes in the response.
Episode Fields If including episodes, select which episode fields to include. Options include UUID, Name/Title, Description, Audio URL, Date Published, Duration, Episode Number, Season Number, Website URL. Defaults to UUID, Name, Description.

Output

The output JSON contains the requested podcast details structured according to the selected response fields. If episodes are included, an array of episode objects is embedded, each containing the selected episode fields.

Example structure (simplified):

{
  "uuid": "string",
  "name": "string",
  "description": "string",
  "imageUrl": "string",
  "itunesId": "number",
  "language": "string",
  "popularityRank": "number",
  "rssUrl": "string",
  "totalEpisodesCount": "number",
  "websiteUrl": "string",
  "countries": ["string"],
  "genres": ["string"],
  "episodes": [
    {
      "uuid": "string",
      "name": "string",
      "description": "string",
      "audioUrl": "string",
      "datePublished": "string",
      "duration": "number",
      "episodeNumber": "number",
      "seasonNumber": "number",
      "websiteUrl": "string"
    }
  ]
}

If binary data were involved (not indicated here), it would typically represent media files like audio streams, but this node focuses on metadata only.

Dependencies

  • Requires an API key credential for authenticating with the Taddy Podcast API.
  • The base URL for API requests is https://api.taddy.org.
  • No additional external dependencies beyond the Taddy API service.

Troubleshooting

  • Common issues:

    • Invalid or missing podcast identifier: Ensure the identifier type matches the provided value format.
    • API authentication errors: Verify that the API key credential is correctly configured and valid.
    • Requesting unsupported fields: Select valid response and episode fields; invalid selections may cause errors or empty responses.
    • Network or connectivity problems: Check internet connection and API availability.

  • Error messages:

    • "Unknown operation: podcast.getDetails": Indicates the operation name might be incorrect or not implemented.
    • API error messages returned in the JSON under an error field if continueOnFail is enabled.

Resolving these usually involves verifying input parameters, credentials, and network status.

Links and References

Discussion