action listennotes_get_best_podcasts {
  label: "Fetch a list of best podcasts by genre"
  description: "Get a list of curated best podcasts by genre,\nwhich are curated by Listen Notes staffs based on various signals from the Internet, e.g.,\ntop charts on other podcast platforms, recommendations from mainstream media,\nuser activities on listennotes.com...\nYou can get the genre ids from `GET /genres` endpoint.\nThis endpoint returns same data as https://www.listennotes.com/best-podcasts/\n"
  provider: listennotes
  method: GET
  path: "/best_podcasts"
  encoding: json
  input: {
    type: "object"
    properties: {
      language: {
        type: "string"
      }
      page: {
        type: "integer"
      }
      publisher_region: {
        type: "string"
      }
      region: {
        type: "string"
      }
      sort: {
        type: "string"
        enum: ["recent_added_first", "oldest_added_first", "recent_published_first", "oldest_published_first", "listen_score"]
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    required: ["has_next", "has_previous", "id", "listennotes_url", "name", "next_page_number", "page_number", "parent_id", "podcasts", "previous_page_number", "total"]
    properties: {
      has_next: {
        type: "boolean"
      }
      has_previous: {
        type: "boolean"
      }
      id: {
        type: "integer"
        description: "The id of this genre"
      }
      listennotes_url: {
        type: "string"
        description: "Url of the list of best podcasts on [ListenNotes.com](https://www.ListenNotes.com)."
      }
      name: {
        type: "string"
        description: "This genre's name."
      }
      next_page_number: {
        type: "integer"
      }
      page_number: {
        type: "integer"
      }
      parent_id: {
        type: "integer"
        description: "The id of parent genre."
      }
      podcasts: {
        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."
            }
          }
        }
      }
      previous_page_number: {
        type: "integer"
      }
      total: {
        type: "integer"
      }
    }
  }
}