Actions8
- Episode Actions
- Latest Episode Actions
- Podcast Actions
- Popular Content Actions
- Search Actions
- Top Chart Actions
- Transcript Actions
Overview
This node interacts with the Taddy Podcast API to retrieve top chart podcast data filtered by genre. It allows users to fetch popular podcasts or episodes within specific genres, optionally filtered by country, and sourced from Apple Podcasts. This is useful for discovering trending content in particular podcast categories or regions.
Practical examples:
- Fetching the top technology podcasts globally.
- Retrieving the most popular comedy episodes in the United States.
- Getting a list of top health and fitness podcasts filtered by multiple sub-genres.
Properties
| Name | Meaning |
|---|---|
| Content Type | Type of content to get top charts for. Options: "Podcasts" (podcast series) or "Episodes". Note: Only Episodes are available when using "By Genres" with a country filter. |
| Genres | One or more podcast genres to filter the top charts by. Includes broad categories like Arts, Business, Comedy, Education, Fiction, Health and Fitness, Music, News, Religion and Spirituality, Science, Sports, Technology, etc., plus many sub-genres. Default is Technology. |
| Filter by Country | Optionally filter results by country. Required if filtering by episodes. Supports a wide range of countries such as United States, Canada, United Kingdom, Australia, and many others. Default is no country filter. |
| Source | Platform source for top charts data. Currently only "Apple Podcasts" is supported. |
| Page | Page number of results to retrieve, between 1 and 20. Defaults to 1. |
| Results Per Page | Number of results per page, between 1 and 25. Defaults to 10. |
Output
The node outputs an array of JSON objects representing the top chart items matching the selected filters. Each item corresponds to either a podcast series or an episode, depending on the chosen content type.
The exact structure of each JSON object depends on the API response but typically includes details such as:
- Podcast or episode title
- Genre(s)
- Ranking position
- Metadata like description, publisher, release date, etc.
No binary data output is indicated.
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 or external services are explicitly required beyond the API key.
Troubleshooting
Common issues:
- Missing or invalid API key will cause authentication errors.
- Selecting episodes without specifying a country filter may result in errors or empty results because episodes require a country filter.
- Requesting pages or results per page outside allowed ranges (page > 20, results > 25) will likely cause validation errors.
- Unknown resource or operation names will throw errors indicating unsupported actions.
Error messages:
"Unknown operation: topCharts.getByGenres": Indicates the operation name is incorrect or not implemented.- API errors related to authentication or rate limits should be resolved by verifying the API key and usage limits.
- Validation errors for input parameters can be fixed by adhering to the specified ranges and required fields.
Links and References
- Taddy Podcast API Documentation (assumed official API docs URL)
- Apple Podcasts Top Charts (for understanding source data context)
This summary is based on static analysis of the node's properties and bundled code for the "Top Chart" resource and "Get by Genre" operation.