action listennotes_get_curated_podcasts {
  label: "Fetch curated lists of podcasts"
  description: "A bunch of curated lists from online media. For each list, you'll get basic info of up to 5 podcasts. To get detailed meta data of all podcasts in a specific list, you need to use `GET /curated_podcasts/{id}`. We add new curated lists to the database on a daily basis.\n"
  provider: listennotes
  method: GET
  path: "/curated_podcasts"
  encoding: json
  input: {
    type: "object"
    properties: {
      page: {
        type: "integer"
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    required: ["curated_lists", "has_next", "has_previous", "next_page_number", "page_number", "previous_page_number", "total"]
    properties: {
      curated_lists: {
        type: "array"
        items: {
          type: "object"
          properties: {
            description: {
              type: "string"
              description: "This curated list's description."
            }
            id: {
              type: "string"
              description: "Curated list id, which can be used to further fetch detailed curated list metadata via `GET /curated_podcasts/{id}`."
            }
            listennotes_url: {
              type: "string"
              description: "The url of this curated list on [ListenNotes.com](https://www.ListenNotes.com)."
            }
            podcasts: {
              type: "array"
              description: "Minimum meta data of up to 5 podcasts in this curated list."
              items: {
                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 of this curated list. In milliseconds."
            }
            source_domain: {
              type: "string"
              description: "The domain name of the source of this curated list."
            }
            source_url: {
              type: "string"
              description: "Url of the source of this curated list."
            }
            title: {
              type: "string"
              description: "Curated list name."
            }
            total: {
              type: "integer"
              description: "The total number of podcasts in this curated list."
            }
          }
        }
      }
      has_next: {
        type: "boolean"
      }
      has_previous: {
        type: "boolean"
      }
      next_page_number: {
        type: "integer"
      }
      page_number: {
        type: "integer"
      }
      previous_page_number: {
        type: "integer"
      }
      total: {
        type: "integer"
      }
    }
  }
}