Actions8
- Episode Actions
- Latest Episode Actions
- Podcast Actions
- Popular Content Actions
- Search Actions
- Top Chart Actions
- Transcript Actions
Overview
This node integrates with the Taddy Podcast API to retrieve top podcast charts filtered by country. It allows users to fetch either top podcast series or episodes from a specified country and platform source (currently only Apple Podcasts). This is useful for applications that need to display trending podcasts or episodes regionally, such as podcast recommendation engines, market research dashboards, or content discovery tools.
For example, you could use this node to get the top 10 podcast series in the United States or the top 15 podcast episodes in Canada, helping tailor content suggestions based on geographic popularity.
Properties
| Name | Meaning |
|---|---|
| Content Type | Type of content to get top charts for. Options: Podcasts (podcast series), Episodes (individual podcast episodes). Note: Only Episodes are available when using "By Genres" with a country filter. |
| Country | The country for which to retrieve top charts. A comprehensive list of countries is provided, e.g., United States, Canada, France, Japan, etc. Selecting "None" means no country filter is applied. |
| Source | Platform source for top charts data. Currently only Apple Podcasts is supported. |
| Page | Page number of results to retrieve, ranging from 1 to 20. Useful for paginating through large result sets. |
| Results Per Page | Number of results per page, ranging from 1 to 25. Controls how many top chart items are returned per request. |
Output
The node outputs JSON data representing the top charts retrieved from the Taddy Podcast API. Each item corresponds to a podcast series or episode depending on the selected content type. The structure includes metadata about each podcast or episode, such as title, ranking, and other relevant details provided by the API.
If binary data were involved (e.g., audio files), it would be summarized here, but this node focuses on JSON metadata output only.
Dependencies
- Requires an API key credential for the Taddy Podcast API.
- The node makes HTTP requests to
https://api.taddy.org. - No additional external dependencies beyond the configured API key and internet access.
Troubleshooting
- Unknown operation error: If the node configuration specifies an unsupported resource-operation combination, it will throw an error indicating the unknown operation. Ensure the Resource is set to "Top Chart" and Operation to "Get by Country".
- API authentication errors: If the API key is missing or invalid, requests will fail. Verify that the API key credential is correctly configured.
- Invalid parameter values: Providing out-of-range values for page or results per page may cause errors. Use values within the allowed ranges (page: 1-20, results per page: 1-25).
- Empty or unexpected results: If the country or content type combination yields no data, check if the selected filters are valid and supported by the API.
Links and References
- Taddy Podcast API Documentation (assumed official API docs)
- Apple Podcasts platform for reference on podcast content types
Note: This summary is based solely on static analysis of the provided code and property definitions without runtime execution.