Taddy API icon

Taddy API

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

Actions8

Overview

The node provides a search interface to the Taddy Podcast API, enabling users to query a large database of podcasts, episodes, comics, and creators. It is designed to help find relevant content by specifying search terms, filtering criteria, and sorting preferences. This node is beneficial for podcast app developers, content curators, marketers, or researchers who want to programmatically discover and retrieve detailed information about audio/video podcasts and related media.

Practical examples include:

  • Searching for podcast episodes about "technology" excluding terms like "crypto".
  • Finding popular podcast series in specific genres or languages.
  • Filtering episodes longer than a certain duration that have transcripts.
  • Retrieving metadata such as episode number, publication date, or popularity rank for integration into custom applications.

Properties

Name Meaning
Search Term The main term to search across podcasts, episodes, comics, and creators. Supports exclusion of terms by prefixing with a minus sign (e.g., Tim Ferriss -crypto).
Exclude Terms Comma-separated list of terms to exclude from results; these are automatically added as exclusions to the search term.
Content Types Types of content to search for. Options: Podcast Series, Podcast Episode, Comic Series, Creator. Default searches podcast series and episodes.
Sort By How to sort the search results. Options: Exactness (matches closest to search term), Popularity (most popular content). Default is Popularity.
Match Type How to match the search terms. Options: All Terms (all must appear), Exact Phrase (exact phrase match), Most Terms (most terms matched). Default is Most Terms.
Page Page number of results to return, between 1 and 20. Default is 1.
Results Per Page Number of results per page, between 1 and 25. Default is 10.
Response Fields Select which fields to include in the response JSON. 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, Popularity Rank. Default is none (all fields returned).
Additional Options Collection of optional filters and flags to refine search results:
- Countries: Filter by comma-separated ISO country codes (e.g., US,GB,CA)
- Duration Greater Than / Less Than (seconds): Filter episodes by length
- Genres: Filter by comma-separated genres (e.g., Technology,Business,News)
- Has Chapters: Boolean filter for episodes with chapters
- Has Transcript: Boolean filter for content with transcripts
- Languages: Filter by comma-separated language codes (e.g., en,es,fr)
- Last Updated After / Before: Filter content updated within a date range
- Podcast Content Type: Filter by AUDIO or VIDEO content
- Podcast UUIDs: Filter by comma-separated podcast unique IDs
- Published After / Before: Filter content published within a date range
- Safe Mode: Boolean to filter out explicit content. Default true.
- Total Episodes Greater Than / Less Than: Filter podcasts by number of episodes

Output

The output is an array of JSON objects representing the search results. Each object contains fields corresponding to the selected response fields plus default metadata. Typical fields include:

  • uuid: Unique identifier of the content.
  • name: Name or title of the podcast, episode, comic, or creator.
  • description: Summary or description text.
  • audioUrl: URL to the audio file (if applicable).
  • datePublished: Publication date.
  • duration: Length in seconds (for episodes).
  • episodeNumber, seasonNumber: Episode and season identifiers.
  • websiteUrl: Link to the official website.
  • podcastDescription, podcastImageUrl: Metadata about the podcast series.
  • itunesId, rssUrl: Identifiers and feeds.
  • popularityRank: Ranking based on popularity.

If binary data were supported, it would typically represent media files, but this node returns only JSON metadata.

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 standard HTTP request capabilities provided by n8n.

Troubleshooting

  • Common issues:

    • Invalid or missing API key will cause authentication errors.
    • Exceeding rate limits imposed by the API may result in throttling or errors.
    • Providing invalid filter values (e.g., malformed dates, unsupported country codes) can cause request failures.
    • Requesting pages beyond available results will return empty arrays.

  • Error messages:

    • "Unknown operation: search.searchContent" indicates a misconfiguration of resource or operation parameters.
    • Network or timeout errors suggest connectivity issues with the API endpoint.
    • Validation errors for input properties usually specify which parameter is incorrect.

  • Resolutions:

    • Verify API credentials and permissions.
    • Check input property formats carefully.
    • Use smaller page sizes or fewer filters if encountering timeouts.
    • Enable "Continue On Fail" in the node settings to handle partial failures gracefully.

Links and References

Discussion