Taddy API · JSON Structure
Taddy Podcast Series Structure
Top-level representation of a podcast in the Taddy API
Type:
Properties: 0
AudioComicsGraphQLMediaPodcastsTranscriptsWebhooks
PodcastSeries is a JSON Structure definition published by Taddy API.
Meta-schema:
JSON Structure
{
"name": "PodcastSeries",
"description": "Top-level representation of a podcast in the Taddy API",
"fields": [
{ "name": "uuid", "type": "ID", "required": true, "description": "Taddy unique identifier" },
{ "name": "name", "type": "String", "required": true, "description": "Podcast title" },
{ "name": "description", "type": "String", "description": "Podcast summary" },
{ "name": "imageUrl", "type": "String (URI)", "description": "Cover art URL" },
{ "name": "websiteUrl", "type": "String (URI)", "description": "Podcast website" },
{ "name": "rssUrl", "type": "String (URI)", "description": "RSS feed URL" },
{ "name": "rssOwnerName", "type": "String", "description": "RSS feed owner" },
{ "name": "authorName", "type": "String", "description": "Podcast author" },
{ "name": "copyright", "type": "String", "description": "Copyright statement" },
{ "name": "totalEpisodesCount", "type": "Int", "description": "Total episode count" },
{ "name": "datePublished", "type": "Int (Epoch)", "description": "Publication date" },
{ "name": "itunesId", "type": "Int", "description": "Apple Podcasts ID" },
{ "name": "seriesType", "type": "Enum (EPISODIC|SERIAL)", "description": "Format type" },
{ "name": "contentType", "type": "Enum (AUDIO|VIDEO)", "description": "Primary content type" },
{ "name": "isExplicitContent", "type": "Boolean", "description": "Explicit content flag" },
{ "name": "isCompleted", "type": "Boolean", "description": "Series concluded flag" },
{ "name": "isBlocked", "type": "Boolean", "description": "Blocked flag" },
{ "name": "genres", "type": "Array[Genre]", "description": "Up to 5 genres ordered by importance" },
{ "name": "language", "type": "Language", "description": "Primary language" },
{ "name": "persons", "type": "Array[Person]", "description": "Hosts and contributors" },
{ "name": "episodes", "type": "Array[PodcastEpisode]", "description": "Paginated episode list", "parameters": ["sortOrder", "page", "limitPerPage", "searchTerm", "includeRemovedEpisodes"] },
{ "name": "popularityRank", "type": "PopularityRank", "description": "Taddy popularity ranking" },
{ "name": "taddyTranscribeStatus", "type": "Enum", "description": "Transcription status" },
{ "name": "hash", "type": "String", "description": "Change detection hash" },
{ "name": "childrenHash", "type": "String", "description": "Episode change detection hash" }
],
"relationships": [
{ "field": "episodes", "relatesTo": "PodcastEpisode", "cardinality": "one-to-many" },
{ "field": "persons", "relatesTo": "Person", "cardinality": "many-to-many" },
{ "field": "genres", "relatesTo": "Genre", "cardinality": "many-to-many" }
]
}