action listennotes_get_podcast_recommendations {
  label: "Fetch recommendations for a podcast"
  description: "Fetch up to 8 podcast recommendations based on the given podcast id."
  provider: listennotes
  method: GET
  path: "/podcasts/{id}/recommendations"
  encoding: json
  input: {
    type: "object"
    properties: {
      id: {
        type: "string"
      }
    }
    required: ["id"]
    additionalProperties: false
  }
  output: {
    type: "object"
    required: ["recommendations"]
    properties: {
      recommendations: {
        type: "array"
        items: {
          type: "object"
          properties: {
            audio_length_sec: {
              type: "integer"
              description: "Average audio length of all episodes of this podcast. In seconds."
            }
            country: {
              type: "string"
              description: "The country where this podcast is produced."
            }
            description: {
              type: "string"
              description: "Html of this episode's full description"
            }
            earliest_pub_date_ms: {
              type: "integer"
              description: "The published date of the oldest episode of this podcast. In milliseconds"
            }
            email: {
              type: "string"
              description: "The email of this podcast's producer. This field is available only in the PRO/ENTERPRISE plan."
            }
            explicit_content: {
              type: "boolean"
              description: "Whether this podcast contains explicit language."
            }
            extra: {
              type: "object"
              properties: {
                amazon_music_url: {
                  type: "string"
                  description: "Amazon Music url for this podcast"
                }
                facebook_handle: {
                  type: "string"
                  description: "Facebook username affiliated with this podcast"
                }
                google_url: {
                  type: "string"
                  description: "Google Podcasts url for this podcast"
                }
                instagram_handle: {
                  type: "string"
                  description: "Instagram username affiliated with this podcast"
                }
                linkedin_url: {
                  type: "string"
                  description: "LinkedIn url affiliated with this podcast"
                }
                patreon_handle: {
                  type: "string"
                  description: "Patreon username affiliated with this podcast"
                }
                spotify_url: {
                  type: "string"
                  description: "Spotify url for this podcast"
                }
                twitter_handle: {
                  type: "string"
                  description: "Twitter username affiliated with this podcast"
                }
                url1: {
                  type: "string"
                  description: "Url affiliated with this podcast"
                }
                url2: {
                  type: "string"
                  description: "Url affiliated with this podcast"
                }
                url3: {
                  type: "string"
                  description: "Url affiliated with this podcast"
                }
                wechat_handle: {
                  type: "string"
                  description: "WeChat username affiliated with this podcast"
                }
                youtube_url: {
                  type: "string"
                  description: "YouTube url affiliated with this podcast"
                }
              }
            }
            genre_ids: {
              type: "array"
              items: {
                type: "integer"
                description: "Genre ids."
              }
            }
            id: {
              type: "string"
              description: "Podcast id, which can be used to further fetch detailed podcast metadata via `GET /podcasts/{id}`."
            }
            image: {
              type: "string"
              description: "Image url for this podcast's artwork. If you are using PRO/ENTERPRISE plan, then it's\na high resolution image (1400x1400). If you are using FREE plan, then it's the same as **thumbnail**,\nlow resolution image (300x300).\n"
            }
            is_claimed: {
              type: "boolean"
              description: "Whether this podcast is claimed by its producer on [ListenNotes.com](https://www.ListenNotes.com)."
            }
            itunes_id: {
              type: "integer"
              description: "iTunes id for this podcast."
            }
            language: {
              type: "string"
              description: "The language of this podcast. You can get all supported languages from `GET /languages`."
            }
            latest_episode_id: {
              type: "string"
              description: "The id of the most recently published episode of this podcast, which can be used to further fetch detailed episode metadata via `GET /episodes/{id}`."
            }
            latest_pub_date_ms: {
              type: "integer"
              description: "The published date of the latest episode of this podcast. In milliseconds"
            }
            listen_score: {
              type: "integer"
              description: "The estimated popularity score of a podcast compared to all other rss-based public podcasts in the world on a scale from 0 to 100.\nIf the score is not available, it'll be null. Learn more at listennotes.com/listen-score\n"
            }
            listen_score_global_rank: {
              type: "string"
              description: "The estimated popularity ranking of a podcast compared to all other rss-based public podcasts in the world.\nFor example, if the value is 0.5%, then this podcast is one of the top 0.5% most popular shows out of all podcasts globally, ranked by Listen Score.\nIf the ranking is not available, it'll be null. Learn more at listennotes.com/listen-score\n"
            }
            listennotes_url: {
              type: "string"
              description: "The url of this podcast on [ListenNotes.com](https://www.ListenNotes.com)."
            }
            looking_for: {
              type: "object"
              properties: {
                cohosts: {
                  type: "boolean"
                  description: "Whether this podcast is looking for cohosts."
                }
                cross_promotion: {
                  type: "boolean"
                  description: "Whether this podcast is looking for cross promotion opportunities with other podcasts."
                }
                guests: {
                  type: "boolean"
                  description: "Whether this podcast is looking for guests."
                }
                sponsors: {
                  type: "boolean"
                  description: "Whether this podcast is looking for sponsors."
                }
              }
            }
            publisher: {
              type: "string"
              description: "Podcast publisher name."
            }
            rss: {
              type: "string"
              description: "RSS url of this podcast. This field is available only in the PRO/ENTERPRISE plan."
            }
            thumbnail: {
              type: "string"
              description: "Thumbnail image url for this podcast's artwork (300x300)."
            }
            title: {
              type: "string"
              description: "Podcast name."
            }
            total_episodes: {
              type: "integer"
              description: "Total number of episodes in this podcast."
            }
            type: {
              type: "string"
              description: "The type of this podcast - episodic or serial."
              enum: ["episodic", "serial"]
            }
            update_frequency_hours: {
              type: "integer"
              description: "How frequently does this podcast release a new episode? In hours. For example, if the value is 166, then it's every 166 hours (or weekly)."
            }
            website: {
              type: "string"
              description: "Website url of this podcast."
            }
          }
        }
      }
    }
  }
}