TheTVDB · Schema

Character

character record

EntertainmentMoviesTelevisionMedia MetadataPublic APIsVideo

Properties

Name	Type	Description
aliases	array
episode	object	base record info
episodeId	integer
id	integer
image	string
isFeatured	boolean
movieId	integer
movie	object	base record info
name	string
nameTranslations	array
overviewTranslations	array
peopleId	integer
personImgURL	string
peopleType	string
seriesId	integer
series	object	base record info
sort	integer
tagOptions	array
type	integer
url	string
personName	string

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/tvdb/refs/heads/main/json-schema/tvdb-character-schema.json",
  "title": "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": "integer",
      "nullable": true,
      "example": 12345
    },
    "id": {
      "format": "int64",
      "type": "integer",
      "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": "integer",
      "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": "integer",
      "example": 12345
    },
    "personImgURL": {
      "type": "string",
      "example": "https://artworks.thetvdb.com/banners/example.jpg"
    },
    "peopleType": {
      "type": "string",
      "example": "example"
    },
    "seriesId": {
      "type": "integer",
      "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": {
      "format": "int64",
      "type": "integer",
      "x-go-name": "Sort",
      "example": 12345
    },
    "tagOptions": {
      "items": {
        "description": "tag option record",
        "properties": {
          "helpText": {
            "type": "string",
            "example": "example"
          },
          "id": {
            "format": "int64",
            "type": "integer",
            "x-go-name": "ID",
            "example": 12345
          },
          "name": {
            "type": "string",
            "x-go-name": "Name",
            "example": "Example Name"
          },
          "tag": {
            "format": "int64",
            "type": "integer",
            "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": {
      "format": "int64",
      "type": "integer",
      "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"
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/tvdb-character"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.