Podcast Episodes

v1.0.0

This endpoint allows the client to retrieve a list of podcast episodes. "Podcast episodes" are episodes belonging to podcasts. It will only return active (reachable) podcast episodes that belong to published podcasts available on the platform, ordered by descending publication date. It supports pagination, each page will contain 30 articles by default.

Input

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "format": "int32"
    },
    "per_page": {
      "type": "integer",
      "format": "int32"
    },
    "username": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

Output

{
  "type": "array",
  "items": {
    "type": "object",
    "description": "Representation of a podcast episode returned in a list",
    "required": [
      "type_of",
      "class_name",
      "id",
      "path",
      "title",
      "image_url",
      "podcast"
    ],
    "properties": {
      "class_name": {
        "type": "string"
      },
      "id": {
        "type": "integer",
        "format": "int32"
      },
      "image_url": {
        "type": "string",
        "format": "url",
        "description": "Podcast episode image url or podcast image url"
      },
      "path": {
        "type": "string",
        "format": "path"
      },
      "podcast": {
        "type": "object",
        "description": "The podcast that the resource belongs to",
        "properties": {
          "image_url": {
            "type": "string",
            "format": "url",
            "description": "Podcast image url"
          },
          "slug": {
            "type": "string"
          },
          "title": {
            "type": "string"
          }
        }
      },
      "title": {
        "type": "string"
      },
      "type_of": {
        "type": "string"
      }
    }
  }
}