TheTVDB · Example Payload

Tvdb Episode Extended Record Example

EntertainmentMoviesTelevisionMedia MetadataPublic APIsVideo

Tvdb Episode Extended Record Example is an example object payload from TheTVDB, with 33 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

airedairsAfterSeasonairsBeforeEpisodeairsBeforeSeasonawardscharacterscompaniescontentRatingsfinaleTypeidimageimageTypeisMovielastUpdatedlinkedMovienamenameTranslationsnetworksnominationsnumberoverviewoverviewTranslationsproductionCoderemoteIdsruntimeseasonNumberseasonsseriesIdstudiostagOptionstrailerstranslationsyear

Example Payload

Raw ↑
{
  "aired": "example",
  "airsAfterSeason": 1,
  "airsBeforeEpisode": 1,
  "airsBeforeSeason": 1,
  "awards": [
    {
      "id": 12345,
      "name": "Example Name"
    }
  ],
  "characters": [
    {
      "aliases": [
        {
          "language": null,
          "name": null
        }
      ],
      "episode": {
        "image": "https://artworks.thetvdb.com/banners/example.jpg",
        "name": "Example Name",
        "year": "2024"
      },
      "episodeId": 12345,
      "id": 12345,
      "image": "https://artworks.thetvdb.com/banners/example.jpg",
      "isFeatured": true,
      "movieId": 12345,
      "movie": {
        "image": "https://artworks.thetvdb.com/banners/example.jpg",
        "name": "Example Name",
        "year": "2024"
      },
      "name": "Example Name",
      "nameTranslations": [
        "example"
      ],
      "overviewTranslations": [
        "example"
      ],
      "peopleId": 12345,
      "personImgURL": "https://artworks.thetvdb.com/banners/example.jpg",
      "peopleType": "example",
      "seriesId": 12345,
      "series": {
        "image": "https://artworks.thetvdb.com/banners/example.jpg",
        "name": "Example Name",
        "year": "2024"
      },
      "sort": 12345,
      "tagOptions": [
        {
          "helpText": null,
          "id": null,
          "name": null,
          "tag": null,
          "tagName": null
        }
      ],
      "type": 12345,
      "url": "https://artworks.thetvdb.com/banners/example.jpg",
      "personName": "example"
    }
  ],
  "companies": [
    {
      "activeDate": "2024-01-15",
      "aliases": [
        {
          "language": null,
          "name": null
        }
      ],
      "country": "usa",
      "id": 12345,
      "inactiveDate": "2024-01-15",
      "name": "Example Name",
      "nameTranslations": [
        "example"
      ],
      "overviewTranslations": [
        "example"
      ],
      "primaryCompanyType": 12345,
      "slug": "example-slug",
      "parentCompany": {
        "id": 12345,
        "name": "Example Name",
        "relation": {
          "id": null,
          "typeName": null
        }
      },
      "tagOptions": [
        {
          "helpText": null,
          "id": null,
          "name": null,
          "tag": null,
          "tagName": null
        }
      ]
    }
  ],
  "contentRatings": [
    {
      "id": 12345,
      "name": "Example Name",
      "description": "A descriptive paragraph of text.",
      "country": "usa",
      "contentType": "example",
      "order": 1,
      "fullName": "example"
    }
  ],
  "finaleType": "example",
  "id": 12345,
  "image": "https://artworks.thetvdb.com/banners/example.jpg",
  "imageType": 1,
  "isMovie": 12345,
  "lastUpdated": "2024-01-15",
  "linkedMovie": 1,
  "name": "Example Name",
  "nameTranslations": [
    "example"
  ],
  "networks": [
    {
      "activeDate": "2024-01-15",
      "aliases": [
        {
          "language": null,
          "name": null
        }
      ],
      "country": "usa",
      "id": 12345,
      "inactiveDate": "2024-01-15",
      "name": "Example Name",
      "nameTranslations": [
        "example"
      ],
      "overviewTranslations": [
        "example"
      ],
      "primaryCompanyType": 12345,
      "slug": "example-slug",
      "parentCompany": {
        "id": 12345,
        "name": "Example Name",
        "relation": {
          "id": null,
          "typeName": null
        }
      },
      "tagOptions": [
        {
          "helpText": null,
          "id": null,
          "name": null,
          "tag": null,
          "tagName": null
        }
      ]
    }
  ],
  "nominations": [
    {
      "character": {
        "aliases": [
          null
        ],
        "episode": {
          "image": null,
          "name": null,
          "year": null
        },
        "episodeId": 12345,
        "id": 12345,
        "image": "https://artworks.thetvdb.com/banners/example.jpg",
        "isFeatured": true,
        "movieId": 12345,
        "movie": {
          "image": null,
          "name": null,
          "year": null
        },
        "name": "Example Name",
        "nameTranslations": [
          "example"
        ],
        "overviewTranslations": [
          "example"
        ],
        "peopleId": 12345,
        "personImgURL": "https://artworks.thetvdb.com/banners/example.jpg",
        "peopleType": "example",
        "seriesId": 12345,
        "series": {
          "image": null,
          "name": null,
          "year": null
        },
        "sort": 12345,
        "tagOptions": [
          null
        ],
        "type": 12345,
        "url": "https://artworks.thetvdb.com/banners/example.jpg",
        "personName": "example"
      },
      "details": "example",
      "episode": {
        "absoluteNumber": 1,
        "aired": "example",
        "airsAfterSeason": 1,
        "airsBeforeEpisode": 1,
        "airsBeforeSeason": 1,
        "finaleType": "example",
        "id": 12345,
        "image": "https://artworks.thetvdb.com/banners/example.jpg",
        "imageType": 1,
        "isMovie": 12345,
        "lastUpdated": "2024-01-15",
        "linkedMovie": 1,
        "name": "Example Name",
        "nameTranslations": [
          "example"
        ],
        "number": 1,
        "overview": "A descriptive paragraph of text.",
        "overviewTranslations": [
          "example"
        ],
        "runtime": 1,
        "seasonNumber": 1,
        "seasons": [
          null
        ],
        "seriesId": 12345,
        "seasonName": "example",
        "year": "2024"
      },
      "id": 12345,
      "isWinner": true,
      "movie": {
        "aliases": [
          null
        ],
        "id": 12345,
        "image": "https://artworks.thetvdb.com/banners/example.jpg",
        "lastUpdated": "2024-01-15",
        "name": "Example Name",
        "nameTranslations": [
          "example"
        ],
        "overviewTranslations": [
          "example"
        ],
        "score": 100,
        "slug": "example-slug",
        "status": "Continuing",
        "runtime": 1,
        "year": "2024"
      },
      "series": {
        "aliases": [
          null
        ],
        "averageRuntime": 1,
        "country": "usa",
        "defaultSeasonType": 12345,
        "episodes": [
          null
        ],
        "firstAired": "example",
        "id": 12345,
        "image": "https://artworks.thetvdb.com/banners/example.jpg",
        "isOrderRandomized": true,
        "lastAired": "example",
        "lastUpdated": "2024-01-15",
        "name": "Example Name",
        "nameTranslations": [
          "example"
        ],
        "nextAired": "example",
        "originalCountry": "example",
        "originalLanguage": "example",
        "overviewTranslations": [
          "example"
        ],
        "score": 100,
        "slug": "example-slug",
        "status": "Continuing",
        "year": "2024"
      },
      "year": "2024",
      "category": "example",
      "name": "Example Name"
    }
  ],
  "number": 1,
  "overview": "A descriptive paragraph of text.",
  "overviewTranslations": [
    "example"
  ],
  "productionCode": "example",
  "remoteIds": [
    {
      "id": "abc123",
      "type": 12345,
      "sourceName": "example"
    }
  ],
  "runtime": 1,
  "seasonNumber": 1,
  "seasons": [
    {
      "id": 12345,
      "image": "https://artworks.thetvdb.com/banners/example.jpg",
      "imageType": 1,
      "lastUpdated": "2024-01-15",
      "name": "Example Name",
      "nameTranslations": [
        "example"
      ],
      "number": 12345,
      "overviewTranslations": [
        "example"
      ],
      "companies": {
        "studio": [
          null
        ],
        "network": [
          null
        ],
        "production": [
          null
        ],
        "distributor": [
          null
        ],
        "special_effects": [
          null
        ]
      },
      "seriesId": 12345,
      "type": {
        "alternateName": "example",
        "id": 12345,
        "name": "Example Name",
        "type": "example"
      },
      "year": "2024"
    }
  ],
  "seriesId": 12345,
  "studios": [
    {
      "activeDate": "2024-01-15",
      "aliases": [
        {
          "language": null,
          "name": null
        }
      ],
      "country": "usa",
      "id": 12345,
      "inactiveDate": "2024-01-15",
      "name": "Example Name",
      "nameTranslations": [
        "example"
      ],
      "overviewTranslations": [
        "example"
      ],
      "primaryCompanyType": 12345,
      "slug": "example-slug",
      "parentCompany": {
        "id": 12345,
        "name": "Example Name",
        "relation": {
          "id": null,
          "typeName": null
        }
      },
      "tagOptions": [
        {
          "helpText": null,
          "id": null,
          "name": null,
          "tag": null,
          "tagName": null
        }
      ]
    }
  ],
  "tagOptions": [
    {
      "helpText": "example",
      "id": 12345,
      "name": "Example Name",
      "tag": 12345,
      "tagName": "example"
    }
  ],
  "trailers": [
    {
      "id": 12345,
      "language": "eng",
      "name": "Example Name",
      "url": "https://artworks.thetvdb.com/banners/example.jpg",
      "runtime": 1
    }
  ],
  "translations": {
    "nameTranslations": [
      {
        "aliases": [
          "example"
        ],
        "isAlias": true,
        "isPrimary": true,
        "language": "eng",
        "name": "Example Name",
        "overview": "A descriptive paragraph of text.",
        "tagline": "example"
      }
    ],
    "overviewTranslations": [
      {
        "aliases": [
          "example"
        ],
        "isAlias": true,
        "isPrimary": true,
        "language": "eng",
        "name": "Example Name",
        "overview": "A descriptive paragraph of text.",
        "tagline": "example"
      }
    ],
    "alias": [
      "example"
    ]
  },
  "year": "2024"
}