TheTVDB · JSON Structure
Tvdb Episode Extended Record Structure
extended episode record
Type: object
Properties: 33
EntertainmentMoviesTelevisionMedia MetadataPublic APIsVideo
EpisodeExtendedRecord is a JSON Structure definition published by TheTVDB, describing 33 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.
Properties
aired
airsAfterSeason
airsBeforeEpisode
airsBeforeSeason
awards
characters
companies
contentRatings
finaleType
id
image
imageType
isMovie
lastUpdated
linkedMovie
name
nameTranslations
networks
nominations
number
overview
overviewTranslations
productionCode
remoteIds
runtime
seasonNumber
seasons
seriesId
studios
tagOptions
trailers
translations
year
Meta-schema: https://json-structure.org/meta/core/v0/#
JSON Structure
{
"$schema": "https://json-structure.org/meta/core/v0/#",
"$id": "https://raw.githubusercontent.com/api-evangelist/tvdb/refs/heads/main/json-structure/tvdb-episode-extended-record-structure.json",
"name": "EpisodeExtendedRecord",
"description": "extended episode record",
"properties": {
"aired": {
"type": "string",
"example": "example"
},
"airsAfterSeason": {
"type": "int32",
"example": 1
},
"airsBeforeEpisode": {
"type": "int32",
"example": 1
},
"airsBeforeSeason": {
"type": "int32",
"example": 1
},
"awards": {
"items": {
"description": "base award record",
"properties": {
"id": {
"type": "int32",
"example": 12345
},
"name": {
"type": "string",
"example": "Example Name"
}
},
"type": "object",
"x-go-package": "github.com/whip-networks/tvdb-api-v4-core/tvdb-api-v4-core/pkg/model"
},
"type": "array",
"x-go-name": "Awards"
},
"characters": {
"items": {
"description": "character record",
"properties": {
"aliases": {
"items": {
"description": "An alias model, which can be associated with a series, season, movie, person, or list.",
"properties": {
"language": {
"type": "string",
"maximum": 4,
"description": "A 3-4 character string indicating the language of the alias, as defined in Language.",
"example": "eng"
},
"name": {
"type": "string",
"maximum": 100,
"description": "A string containing the alias itself.",
"example": "Example Name"
}
},
"type": "object"
},
"type": "array",
"x-go-name": "Aliases"
},
"episode": {
"description": "base record info",
"properties": {
"image": {
"type": "string",
"x-go-name": "Image",
"example": "https://artworks.thetvdb.com/banners/example.jpg"
},
"name": {
"type": "string",
"x-go-name": "Name",
"example": "Example Name"
},
"year": {
"type": "string",
"example": "2024"
}
},
"type": "object",
"x-go-package": "github.com/whip-networks/tvdb-api-v4-core/tvdb-api-v4-core/pkg/model"
},
"episodeId": {
"type": "int32",
"nullable": true,
"example": 12345
},
"id": {
"type": "int64",
"x-go-name": "ID",
"example": 12345
},
"image": {
"type": "string",
"example": "https://artworks.thetvdb.com/banners/example.jpg"
},
"isFeatured": {
"type": "boolean",
"x-go-name": "IsFeatured",
"example": true
},
"movieId": {
"type": "int32",
"nullable": true,
"example": 12345
},
"movie": {
"description": "base record info",
"properties": {
"image": {
"type": "string",
"x-go-name": "Image",
"example": "https://artworks.thetvdb.com/banners/example.jpg"
},
"name": {
"type": "string",
"x-go-name": "Name",
"example": "Example Name"
},
"year": {
"type": "string",
"example": "2024"
}
},
"type": "object",
"x-go-package": "github.com/whip-networks/tvdb-api-v4-core/tvdb-api-v4-core/pkg/model"
},
"name": {
"type": "string",
"example": "Example Name"
},
"nameTranslations": {
"items": {
"type": "string"
},
"type": "array",
"x-go-name": "NameTranslations",
"example": [
"example"
]
},
"overviewTranslations": {
"items": {
"type": "string"
},
"type": "array",
"x-go-name": "OverviewTranslations",
"example": [
"example"
]
},
"peopleId": {
"type": "int32",
"example": 12345
},
"personImgURL": {
"type": "string",
"example": "https://artworks.thetvdb.com/banners/example.jpg"
},
"peopleType": {
"type": "string",
"example": "example"
},
"seriesId": {
"type": "int32",
"nullable": true,
"example": 12345
},
"series": {
"description": "base record info",
"properties": {
"image": {
"type": "string",
"x-go-name": "Image",
"example": "https://artworks.thetvdb.com/banners/example.jpg"
},
"name": {
"type": "string",
"x-go-name": "Name",
"example": "Example Name"
},
"year": {
"type": "string",
"example": "2024"
}
},
"type": "object",
"x-go-package": "github.com/whip-networks/tvdb-api-v4-core/tvdb-api-v4-core/pkg/model"
},
"sort": {
"type": "int64",
"x-go-name": "Sort",
"example": 12345
},
"tagOptions": {
"items": {
"description": "tag option record",
"properties": {
"helpText": {
"type": "string",
"example": "example"
},
"id": {
"type": "int64",
"x-go-name": "ID",
"example": 12345
},
"name": {
"type": "string",
"x-go-name": "Name",
"example": "Example Name"
},
"tag": {
"type": "int64",
"x-go-name": "Tag",
"example": 12345
},
"tagName": {
"type": "string",
"x-go-name": "TagName",
"example": "example"
}
},
"type": "object",
"x-go-package": "github.com/whip-networks/tvdb-api-v4-core/tvdb-api-v4-core/pkg/model"
},
"type": "array",
"x-go-name": "TagOptions"
},
"type": {
"type": "int64",
"x-go-name": "Type",
"example": 12345
},
"url": {
"type": "string",
"x-go-name": "URL",
"example": "https://artworks.thetvdb.com/banners/example.jpg"
},
"personName": {
"type": "string",
"example": "example"
}
},
"type": "object",
"x-go-package": "github.com/whip-networks/tvdb-api-v4-core/tvdb-api-v4-core/pkg/model"
},
"type": "array",
"x-go-name": "Characters"
},
"companies": {
"items": {
"description": "A company record",
"properties": {
"activeDate": {
"type": "string",
"example": "2024-01-15"
},
"aliases": {
"items": {
"description": "An alias model, which can be associated with a series, season, movie, person, or list.",
"properties": {
"language": {
"type": "string",
"maximum": 4,
"description": "A 3-4 character string indicating the language of the alias, as defined in Language.",
"example": "eng"
},
"name": {
"type": "string",
"maximum": 100,
"description": "A string containing the alias itself.",
"example": "Example Name"
}
},
"type": "object"
},
"type": "array",
"x-go-name": "Aliases"
},
"country": {
"type": "string",
"example": "usa"
},
"id": {
"type": "int64",
"x-go-name": "ID",
"example": 12345
},
"inactiveDate": {
"type": "string",
"example": "2024-01-15"
},
"name": {
"type": "string",
"example": "Example Name"
},
"nameTranslations": {
"items": {
"type": "string"
},
"type": "array",
"x-go-name": "NameTranslations",
"example": [
"example"
]
},
"overviewTranslations": {
"items": {
"type": "string"
},
"type": "array",
"x-go-name": "OverviewTranslations",
"example": [
"example"
]
},
"primaryCompanyType": {
"type": "int64",
"x-go-name": "PrimaryCompanyType",
"nullable": true,
"example": 12345
},
"slug": {
"type": "string",
"x-go-name": "Slug",
"example": "example-slug"
},
"parentCompany": {
"type": "object",
"description": "A parent company record",
"properties": {
"id": {
"type": "int32",
"nullable": true,
"example": 12345
},
"name": {
"type": "string",
"example": "Example Name"
},
"relation": {
"type": "object",
"description": "A company relationship",
"properties": {
"id": {
"type": "int32",
"nullable": true,
"example": 12345
},
"typeName": {
"type": "string",
"example": "example"
}
}
}
}
},
"tagOptions": {
"items": {
"description": "tag option record",
"properties": {
"helpText": {
"type": "string",
"example": "example"
},
"id": {
"type": "int64",
"x-go-name": "ID",
"example": 12345
},
"name": {
"type": "string",
"x-go-name": "Name",
"example": "Example Name"
},
"tag": {
"type": "int64",
"x-go-name": "Tag",
"example": 12345
},
"tagName": {
"type": "string",
"x-go-name": "TagName",
"example": "example"
}
},
"type": "object",
"x-go-package": "github.com/whip-networks/tvdb-api-v4-core/tvdb-api-v4-core/pkg/model"
},
"type": "array",
"x-go-name": "TagOptions"
}
},
"type": "object",
"x-go-package": "github.com/whip-networks/tvdb-api-v4-core/tvdb-api-v4-core/pkg/model"
},
"type": "array"
},
"contentRatings": {
"items": {
"description": "content rating record",
"properties": {
"id": {
"type": "int64",
"x-go-name": "ID",
"example": 12345
},
"name": {
"type": "string",
"x-go-name": "Name",
"example": "Example Name"
},
"description": {
"type": "string",
"example": "A descriptive paragraph of text."
},
"country": {
"type": "string",
"example": "usa"
},
"contentType": {
"type": "string",
"example": "example"
},
"order": {
"type": "int32",
"example": 1
},
"fullName": {
"type": "string",
"example": "example"
}
},
"type": "object",
"x-go-package": "github.com/whip-networks/tvdb-api-v4-core/tvdb-api-v4-core/pkg/model"
},
"type": "array",
"x-go-name": "ContentRatings"
},
"finaleType": {
"description": "season, midseason, or series",
"type": "string",
"example": "example"
},
"id": {
"type": "int64",
"x-go-name": "ID",
"example": 12345
},
"image": {
"type": "string",
"example": "https://artworks.thetvdb.com/banners/example.jpg"
},
"imageType": {
"type": "int32",
"nullable": true,
"example": 1
},
"isMovie": {
"type": "int64",
"x-go-name": "IsMovie",
"example": 12345
},
"lastUpdated": {
"type": "string",
"example": "2024-01-15"
},
"linkedMovie": {
"type": "int32",
"example": 1
},
"name": {
"type": "string",
"example": "Example Name"
},
"nameTranslations": {
"items": {
"type": "string"
},
"type": "array",
"x-go-name": "NameTranslations",
"example": [
"example"
]
},
"networks": {
"items": {
"description": "A company record",
"properties": {
"activeDate": {
"type": "string",
"example": "2024-01-15"
},
"aliases": {
"items": {
"description": "An alias model, which can be associated with a series, season, movie, person, or list.",
"properties": {
"language": {
"type": "string",
"maximum": 4,
"description": "A 3-4 character string indicating the language of the alias, as defined in Language.",
"example": "eng"
},
"name": {
"type": "string",
"maximum": 100,
"description": "A string containing the alias itself.",
"example": "Example Name"
}
},
"type": "object"
},
"type": "array",
"x-go-name": "Aliases"
},
"country": {
"type": "string",
"example": "usa"
},
"id": {
"type": "int64",
"x-go-name": "ID",
"example": 12345
},
"inactiveDate": {
"type": "string",
"example": "2024-01-15"
},
"name": {
"type": "string",
"example": "Example Name"
},
"nameTranslations": {
"items": {
"type": "string"
},
"type": "array",
"x-go-name": "NameTranslations",
"example": [
"example"
]
},
"overviewTranslations": {
"items": {
"type": "string"
},
"type": "array",
"x-go-name": "OverviewTranslations",
"example": [
"example"
]
},
"primaryCompanyType": {
"type": "int64",
"x-go-name": "PrimaryCompanyType",
"nullable": true,
"example": 12345
},
"slug": {
"type": "string",
"x-go-name": "Slug",
"example": "example-slug"
},
"parentCompany": {
"type": "object",
"description": "A parent company record",
"properties": {
"id": {
"type": "int32",
"nullable": true,
"example": 12345
},
"name": {
"type": "string",
"example": "Example Name"
},
"relation": {
"type": "object",
"description": "A company relationship",
"properties": {
"id": {
"type": "int32",
"nullable": true,
"example": 12345
},
"typeName": {
"type": "string",
"example": "example"
}
}
}
}
},
"tagOptions": {
"items": {
"description": "tag option record",
"properties": {
"helpText": {
"type": "string",
"example": "example"
},
"id": {
"type": "int64",
"x-go-name": "ID",
"example": 12345
},
"name": {
"type": "string",
"x-go-name": "Name",
"example": "Example Name"
},
"tag": {
"type": "int64",
"x-go-name": "Tag",
"example": 12345
},
"tagName": {
"type": "string",
"x-go-name": "TagName",
"example": "example"
}
},
"type": "object",
"x-go-package": "github.com/whip-networks/tvdb-api-v4-core/tvdb-api-v4-core/pkg/model"
},
"type": "array",
"x-go-name": "TagOptions"
}
},
"type": "object",
"x-go-package": "github.com/whip-networks/tvdb-api-v4-core/tvdb-api-v4-core/pkg/model"
},
"type": "array"
},
"nominations": {
"items": {
"description": "base award nominee record",
"properties": {
"character": {
"description": "character record",
"properties": {
"aliases": {
"items": {
"description": "An alias model, which can be associated with a series, season, movie, person, or list.",
"properties": {
"language": {
"type": "string",
"maximum": 4,
"description": "A 3-4 character string indicating the language of the alias, as defined in Language.",
"example": "eng"
},
"name": {
"type": "string",
"maximum": 100,
"description": "A string containing the alias itself.",
"example": "Example Name"
}
},
"type": "object"
},
"type": "array",
"x-go-name": "Aliases"
},
"episode": {
"description": "base record info",
"properties": {
"image": {
"type": "string",
"x-go-name": "Image",
"example": "https://artworks.thetvdb.com/banners/example.jpg"
},
"name": {
"type": "string",
"x-go-name": "Name",
"example": "Example Name"
},
"year": {
"type": "string",
"example": "2024"
}
},
"type": "object",
"x-go-package": "github.com/whip-networks/tvdb-api-v4-core/tvdb-api-v4-core/pkg/model"
},
"episodeId": {
"type": "int32",
"nullable": true,
"example": 12345
},
"id": {
"type": "int64",
"x-go-name": "ID",
"example": 12345
},
"image": {
"type": "string",
"example": "https://artworks.thetvdb.com/banners/example.jpg"
},
"isFeatured": {
"type": "boolean",
"x-go-name": "IsFeatured",
"example": true
},
"movieId": {
"type": "int32",
"nullable": true,
"example": 12345
},
"movie": {
"description": "base record info",
"properties": {
"image": {
"type": "string",
"x-go-name": "Image",
"example": "https://artworks.thetvdb.com/banners/example.jpg"
},
"name": {
"type": "string",
"x-go-name": "Name",
"example": "Example Name"
},
"year": {
"type": "string",
"example": "2024"
}
},
"type": "object",
"x-go-package": "github.com/whip-networks/tvdb-api-v4-core/tvdb-api-v4-core/pkg/model"
},
"name": {
"type": "string",
"example": "Example Name"
},
"nameTranslations": {
"items": {
"type": "string"
},
"type": "array",
"x-go-name": "NameTranslations",
"example": [
"example"
]
},
"overviewTranslations": {
"items": {
"type": "string"
},
"type": "array",
"x-go-name": "OverviewTranslations",
"example": [
"example"
]
},
"peopleId": {
"type": "int32",
"example": 12345
},
"personImgURL": {
"type": "string",
"example": "https://artworks.thetvdb.com/banners/example.jpg"
},
"peopleType": {
"type": "string",
"example": "example"
},
"seriesId": {
"type": "int32",
"nullable": true,
"example": 12345
},
"series": {
"description": "base record info",
"properties": {
"image": {
"type": "string",
"x-go-name": "Image",
"example": "https://artworks.thetvdb.com/banners/example.jpg"
},
"name": {
"type": "string",
"x-go-name": "Name",
"example": "Example Name"
},
"year": {
"type": "string",
"example": "2024"
}
},
"type": "object",
"x-go-package": "github.com/whip-networks/tvdb-api-v4-core/tvdb-api-v4-core/pkg/model"
},
"sort": {
"type": "int64",
"x-go-name": "Sort",
"example": 12345
},
"tagOptions": {
"items": {
"description": "tag option record",
"properties": {
"helpText": {
"type": "string",
"example": "example"
},
"id": {
"type": "int64",
"x-go-name": "ID",
"example": 12345
},
"name": {
"type": "string",
"x-go-name": "Name",
"example": "Example Name"
},
"tag": {
"type": "int64",
"x-go-name": "Tag",
"example": 12345
},
"tagName": {
"type": "string",
"x-go-name": "TagName",
"example": "example"
}
},
"type": "object",
"x-go-package": "github.com/whip-networks/tvdb-api-v4-core/tvdb-api-v4-core/pkg/model"
},
"type": "array",
"x-go-name": "TagOptions"
},
"type": {
"type": "int64",
"x-go-name": "Type",
"example": 12345
},
"url": {
"type": "string",
"x-go-name": "URL",
"example": "https://artworks.thetvdb.com/banners/example.jpg"
},
"personName": {
"type": "string",
"example": "example"
}
},
"type": "object",
"x-go-package": "github.com/whip-networks/tvdb-api-v4-core/tvdb-api-v4-core/pkg/model"
},
"details": {
"type": "string",
"example": "example"
},
"episode": {
"description": "base episode record",
"properties": {
"absoluteNumber": {
"type": "int32",
"example": 1
},
"aired": {
"type": "string",
"example": "example"
},
"airsAfterSeason": {
"type": "int32",
"example": 1
},
"airsBeforeEpisode": {
"type": "int32",
"example": 1
},
"airsBeforeSeason": {
"type": "int32",
"example": 1
},
"finaleType": {
"description": "season, midseason, or series",
"type": "string",
"example": "example"
},
"id": {
"type": "int64",
"x-go-name": "ID",
"example": 12345
},
"image": {
"type": "string",
"example": "https://artworks.thetvdb.com/banners/example.jpg"
},
"imageType": {
"type": "int32",
"nullable": true,
"example": 1
},
"isMovie": {
"type": "int64",
"x-go-name": "IsMovie",
"example": 12345
},
"lastUpdated": {
"type": "string",
"example": "2024-01-15"
},
"linkedMovie": {
"type": "int32",
"example": 1
},
"name": {
"type": "string",
"example": "Example Name"
},
"nameTranslations": {
"items": {
"type": "string"
},
"type": "array",
"x-go-name": "NameTranslations",
"example": [
"example"
]
},
"number": {
"type": "int32",
"example": 1
},
"overview": {
"type": "string",
"example": "A descriptive paragraph of text."
},
"overviewTranslations": {
"items": {
"type": "string"
},
"type": "array",
"x-go-name": "OverviewTranslations",
"example": [
"example"
]
},
"runtime": {
"type": "int32",
"nullable": true,
"example": 1
},
"seasonNumber": {
"type": "int32",
"example": 1
},
"seasons": {
"items": {
"description": "season genre record",
"properties": {
"id": {
"type": "int32",
"example": 12345
},
"image": {
"type": "string",
"example": "https://artworks.thetvdb.com/banners/example.jpg"
},
"imageType": {
"type": "int32",
"example": 1
},
"lastUpdated": {
"type": "string",
"example": "2024-01-15"
},
"name": {
"type": "string",
"example": "Example Name"
},
"nameTranslations": {
"items": {
"type": "string"
},
"type": "array",
"x-go-name": "NameTranslations",
"example": [
"example"
]
},
"number": {
"type": "int64",
"x-go-name": "Number",
"example": 12345
},
"overviewTranslations": {
"items": {
"type": "string"
},
"type": "array",
"x-go-name": "OverviewTranslations",
"example": [
"example"
]
},
"companies": {
"type": "object",
"description": "Companies by type record",
"properties": {
"studio": {
"type": "array",
"items": {
"description": "A company record",
"properties": {
"activeDate": {
"type": "string",
"example": "2024-01-15"
},
"aliases": {
"items": {
"description": "An alias model, which can be associated with a series, season, movie, person, or list.",
"properties": {
"language": {
"type": "string",
"maximum": 4,
"description": "A 3-4 character string indicating the language of the alias, as defined in Language.",
"example": "eng"
},
"name": {
"type": "string",
"maximum": 100,
"description": "A string containing the alias itself.",
"example": "Example Name"
}
},
"type": "object"
},
"type": "arra
# --- truncated at 32 KB (170 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/tvdb/refs/heads/main/json-structure/tvdb-episode-extended-record-structure.json