Podcast

Context

In the context of this API, podcasts are a resource that groups and holds the many podcast episodes that we own in the catalog. The podcasts a user has access to are based on their credentials stored in their JWT.

Users can browse, search, like, play podcasts and podcast episodes. More on this in Playing a Resource and Using User Profiles

Podcast Example

Every podcast has its title and description which are labels used to describe and give an idea of what the podcast is about. Podcasts have a release date, a list of available languages and the number of episodes.

Finally, podcasts have 1 nested field, a list of hosts who appears in the podcast. The host, or artist info, contains the name and id of the host artist.

This is an example of a podcast

{
  "id": "00",
  "title": "Fungus Found in Yellowstone is Key Ingredient in New Meat Substitute",
  "description": "Welcome to \"Fungus found in Yellowstone is key ingredient in new meat [...]",
  "thumbnailUrl": "https://img.stingray.com/v3/MI9_nadeO15KEasT5hnIFrHZ5WjCGLQ7mOdTR4W8m7M",
  "hosts": [
    {
      "id": "00",
      "name": "Dr. Anthony Leiserowitz"
    }
  ],
  "releaseDate": -1,
  "language": [
    "eng"
  ],
  "episodeCount": 1
}

Podcast Episode Example

Podcast episode have somewhat the same fields as podcasts. they have the same title and thumbnail url and a list of artists. The difference lies in the fact that the episodes have their duration in milliseconds.

This is an example of a podcast episode

    {
      "id": "11",
      "title": "Fungus Found in Yellowstone is Key Ingredient in New Meat Substitute",
      "thumbnailUrl": "https://img.stingray.com/v3/7Jp-1dKYh7NaFwKSmc_-EwBGKEr3obTDi9-uoMKCWj0",
      "artists": [
        {
          "id": "11",
          "name": "Calm Radio"
        }
      ],
      "durationMs": 90031
    }