TheTVDB · JSON Structure
Tvdb Movie Extended Record Structure
extended movie record
Type: object
Properties: 36
EntertainmentMoviesTelevisionMedia MetadataPublic APIsVideo
MovieExtendedRecord is a JSON Structure definition published by TheTVDB, describing 36 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.
Properties
aliases
artworks
audioLanguages
awards
boxOffice
boxOfficeUS
budget
characters
companies
contentRatings
first_release
genres
id
image
inspirations
lastUpdated
lists
name
nameTranslations
originalCountry
originalLanguage
overviewTranslations
production_countries
releases
remoteIds
runtime
score
slug
spoken_languages
status
studios
subtitleLanguages
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-movie-extended-record-structure.json",
"name": "MovieExtendedRecord",
"description": "extended movie 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"
},
"artworks": {
"items": {
"description": "base artwork record",
"properties": {
"height": {
"type": "int64",
"x-go-name": "Height",
"example": 12345
},
"id": {
"type": "int32",
"example": 12345
},
"image": {
"type": "string",
"x-go-name": "Image",
"example": "https://artworks.thetvdb.com/banners/example.jpg"
},
"includesText": {
"type": "boolean",
"example": true
},
"language": {
"type": "string",
"example": "eng"
},
"score": {
"type": "double",
"example": 100
},
"thumbnail": {
"type": "string",
"x-go-name": "Thumbnail",
"example": "example"
},
"type": {
"type": "int64",
"x-go-name": "Type",
"description": "The artwork type corresponds to the ids from the /artwork/types endpoint.",
"example": 12345
},
"width": {
"type": "int64",
"x-go-name": "Width",
"example": 12345
}
},
"type": "object",
"x-go-package": "github.com/whip-networks/tvdb-api-v4-core/tvdb-api-v4-core/pkg/model"
},
"type": "array",
"x-go-name": "Artworks"
},
"audioLanguages": {
"items": {
"type": "string"
},
"type": "array",
"x-go-name": "AudioLanguages",
"example": [
"example"
]
},
"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"
},
"boxOffice": {
"type": "string",
"example": "example"
},
"boxOfficeUS": {
"type": "string",
"example": "example"
},
"budget": {
"type": "string",
"example": "example"
},
"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": {
"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": "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"
}
},
"network": {
"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": "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"
}
},
"production": {
"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": "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"
}
},
"distributor": {
"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": "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"
}
},
"special_effects": {
"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": "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"
]
},
# --- truncated at 32 KB (51 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/tvdb/refs/heads/main/json-structure/tvdb-movie-extended-record-structure.json