Taddy API icon

Taddy API

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

Actions8

Overview

This node interacts with the Taddy Podcast API to retrieve popular podcast content. Specifically, the "Popular Content" resource with the "Get" operation allows users to fetch lists of popular podcasts filtered by language, genres, and pagination options. This is useful for applications that want to display trending or highly ranked podcasts in various categories or languages.

Practical examples include:

  • Building a podcast discovery app that shows top podcasts by genre.
  • Creating a dashboard that highlights popular podcasts in a specific language.
  • Integrating popular podcast data into newsletters or social media posts.

Properties

Name Meaning
Language Filter results by language code (e.g., "en" for English). Optional.
Genres Filter results by one or more podcast genres. Multiple selections allowed. If empty, includes all genres. Options include Arts, Business, Comedy, Education, Fiction, Health and Fitness, History, Kids and Family, Leisure, Music, News, Religion and Spirituality, Science, Society and Culture, Sports, Technology, True Crime, TV and Film, and many subcategories within these.
Page Page number for paginated results, from 1 to 20.
Results Per Page Number of results per page, from 1 to 25.
Response Fields Select which 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, and Genres.

Output

The output is a JSON array where each item represents a popular podcast series matching the query parameters. The fields included depend on the selected "Response Fields" property. Typical fields are:

  • uuid: Unique identifier of the podcast.
  • name: Name or title of the podcast.
  • description: Summary or description of the podcast.
  • imageUrl: URL to cover art or image.
  • itunesId: Identifier used by iTunes.
  • language: Language code of the content.
  • popularityRank: Ranking based on popularity.
  • rssUrl: RSS feed URL.
  • totalEpisodesCount: Number of episodes available.
  • websiteUrl: Official website URL.
  • countries: Associated countries.
  • genres: List of genres the podcast belongs to.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the Taddy Podcast API.
  • The base URL for API requests is https://api.taddy.org.
  • Proper configuration of the API key credential in n8n is necessary.

Troubleshooting

  • Common issues:
    • Invalid or missing API key will cause authentication errors.
    • Requesting pages beyond the maximum (page > 20) or results per page beyond limits (more than 25) may result in errors.
    • Selecting invalid or unsupported genres could lead to empty results or errors.
  • Error messages:
    • "Unknown operation" error if the resource or operation name is incorrect.
    • API errors related to rate limiting or quota exceeded.
  • Resolutions:
    • Verify API key validity and permissions.
    • Ensure input values respect allowed ranges and options.
    • Check network connectivity and API service status.

Links and References

Discussion