action listennotes_get_episode_recommendations {
  label: "Fetch recommendations for an episode"
  description: "Fetch up to 8 episode recommendations based on the given episode id."
  provider: listennotes
  method: GET
  path: "/episodes/{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: {
              type: "string"
              description: "Audio url of this episode, which can be played directly."
            }
            audio_length_sec: {
              type: "integer"
              description: "Audio length of this episode. In seconds."
            }
            description: {
              type: "string"
              description: "Html of this episode's full description"
            }
            explicit_content: {
              type: "boolean"
              description: "Whether this podcast contains explicit language."
            }
            id: {
              type: "string"
              description: "Episode id, which can be used to further fetch detailed episode metadata via `GET /episodes/{id}`."
            }
            image: {
              type: "string"
              description: "Image url for this episode.\nIf an episode doesn't have its own image, then this field would be the url of the podcast artwork image.\nIf 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"
            }
            link: {
              type: "string"
              description: "Web link of this episode."
            }
            listennotes_edit_url: {
              type: "string"
              description: "Edit url of this episode where you can update the audio url if you find the audio is broken."
            }
            listennotes_url: {
              type: "string"
              description: "The url of this episode on [ListenNotes.com](https://www.ListenNotes.com)."
            }
            maybe_audio_invalid: {
              type: "boolean"
              description: "Whether or not this episode's audio is invalid. Podcasters may delete the original audio."
            }
            podcast: {
              type: "object"
              properties: {
                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"
                }
                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)."
                }
                publisher: {
                  type: "string"
                  description: "Podcast publisher name."
                }
                thumbnail: {
                  type: "string"
                  description: "Thumbnail image url for this podcast's artwork (300x300)."
                }
                title: {
                  type: "string"
                  description: "Podcast name."
                }
              }
            }
            pub_date_ms: {
              type: "integer"
              description: "Published date for this episode. In millisecond."
            }
            thumbnail: {
              type: "string"
              description: "Thumbnail image (300x300) url for this episode.\nIf an episode doesn't have its own image, then this field would be the url of the podcast artwork thumbnail image.\n"
            }
            title: {
              type: "string"
              description: "Episode name."
            }
          }
        }
      }
    }
  }
}