podcastindexjs/src/schemas/1.0/episodes-random.json

client-side JS library for interacting with the Podcast Index API

{
  "title": "`/api/1.0/episodes/random` - This call returns a random batch of [max] episodes, in no specific order.",
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": ["true"]
    },
    "max": {
      "type": "string"
    },
    "episodes": {
      "type": "array",
      "items": {
        "$ref": "#/definitions/PIApiRandomEpisode"
      }
    },
    "count": {
      "type": "number"
    },
    "description": {
      "type": "string"
    }
  },
  "additionalProperties": false,
  "required": ["count", "description", "episodes", "max", "status"],
  "definitions": {
    "PIApiRandomEpisode": {
      "description": "Returned by episodesRandom",
      "type": "object",
      "properties": {
        "feedTitle": {
          "type": "string"
        },
        "categories": {
          "description": "category id: name, NOTE: this is not always present on the raw responses and will be populated with an empty object when missing form the api response",
          "anyOf": [
            {
              "type": "object",
              "additionalProperties": {
                "type": "string"
              }
            },
            {
              "type": "null"
            }
          ]
        },
        "id": {
          "type": "number"
        },
        "title": {
          "type": "string"
        },
        "link": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "guid": {
          "type": "string"
        },
        "datePublished": {
          "type": "number"
        },
        "datePublishedPretty": {
          "type": "string"
        },
        "dateCrawled": {
          "type": "number"
        },
        "enclosureUrl": {
          "type": "string"
        },
        "enclosureType": {
          "type": "string"
        },
        "enclosureLength": {
          "type": "number"
        },
        "explicit": {
          "type": "number"
        },
        "episode": {
          "type": ["null", "number"]
        },
        "episodeType": {
          "type": ["null", "string"]
        },
        "season": {
          "type": "number"
        },
        "image": {
          "description": "URL to episode image",
          "type": "string"
        },
        "feedItunesId": {
          "type": ["null", "number"]
        },
        "feedImage": {
          "description": "URL to feed image",
          "type": "string"
        },
        "feedId": {
          "type": "number"
        },
        "feedLanguage": {
          "type": "string"
        },
        "chaptersUrl": {
          "type": ["null", "string"]
        },
        "soundbite": {
          "type": "object",
          "properties": {
            "startTime": {
              "type": "number"
            },
            "duration": {
              "type": "number"
            },
            "title": {
              "type": "string"
            }
          },
          "additionalProperties": false,
          "required": ["duration", "startTime", "title"]
        },
        "soundbites": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "startTime": {
                "type": "number"
              },
              "duration": {
                "type": "number"
              },
              "title": {
                "type": "string"
              }
            },
            "additionalProperties": false,
            "required": ["duration", "startTime", "title"]
          }
        }
      },
      "additionalProperties": false,
      "required": [
        "categories",
        "chaptersUrl",
        "dateCrawled",
        "datePublished",
        "datePublishedPretty",
        "description",
        "enclosureLength",
        "enclosureType",
        "enclosureUrl",
        "episode",
        "episodeType",
        "explicit",
        "feedId",
        "feedImage",
        "feedItunesId",
        "feedLanguage",
        "feedTitle",
        "guid",
        "id",
        "image",
        "link",
        "season",
        "title"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}