action listennotes_get_episode_by_id {
  label: "Fetch detailed meta data for an episode by id"
  description: "Fetch detailed meta data for a specific episode."
  provider: listennotes
  method: GET
  path: "/episodes/{id}"
  encoding: json
  input: {
    type: "object"
    properties: {
      id: {
        type: "string"
      }
      show_transcript: {
        type: "integer"
      }
    }
    required: ["id"]
    additionalProperties: false
  }
  output: {
    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: {
          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: "object"
            additionalProperties: true
          }
          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."
          }
        }
      }
      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."
      }
      transcript: {
        type: "string"
        description: "The transcript of this episode, in plain text (with the newline character \\n). If there's not transcript, it is null. This field is available only in the PRO/ENTERPRISE plan."
      }
    }
  }
}