TheTVDB · Example Payload

Tvdb Season Extended Record Example

EntertainmentMoviesTelevisionMedia MetadataPublic APIsVideo

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

Top-level fields

artworkcompaniesepisodesidimageimageTypelastUpdatednamenameTranslationsnumberoverviewTranslationsseriesIdtrailerstypetagOptionstranslationsyear

Example Payload

Raw ↑
{
  "artwork": [
    {
      "height": 12345,
      "id": 12345,
      "image": "https://artworks.thetvdb.com/banners/example.jpg",
      "includesText": true,
      "language": "eng",
      "score": 100,
      "thumbnail": "example",
      "type": 12345,
      "width": 12345
    }
  ],
  "companies": {
    "studio": [
      {
        "activeDate": "2024-01-15",
        "aliases": [
          null
        ],
        "country": "usa",
        "id": 12345,
        "inactiveDate": "2024-01-15",
        "name": "Example Name",
        "nameTranslations": [
          "example"
        ],
        "overviewTranslations": [
          "example"
        ],
        "primaryCompanyType": 12345,
        "slug": "example-slug",
        "parentCompany": {
          "id": null,
          "name": null,
          "relation": null
        },
        "tagOptions": [
          null
        ]
      }
    ],
    "network": [
      {
        "activeDate": "2024-01-15",
        "aliases": [
          null
        ],
        "country": "usa",
        "id": 12345,
        "inactiveDate": "2024-01-15",
        "name": "Example Name",
        "nameTranslations": [
          "example"
        ],
        "overviewTranslations": [
          "example"
        ],
        "primaryCompanyType": 12345,
        "slug": "example-slug",
        "parentCompany": {
          "id": null,
          "name": null,
          "relation": null
        },
        "tagOptions": [
          null
        ]
      }
    ],
    "production": [
      {
        "activeDate": "2024-01-15",
        "aliases": [
          null
        ],
        "country": "usa",
        "id": 12345,
        "inactiveDate": "2024-01-15",
        "name": "Example Name",
        "nameTranslations": [
          "example"
        ],
        "overviewTranslations": [
          "example"
        ],
        "primaryCompanyType": 12345,
        "slug": "example-slug",
        "parentCompany": {
          "id": null,
          "name": null,
          "relation": null
        },
        "tagOptions": [
          null
        ]
      }
    ],
    "distributor": [
      {
        "activeDate": "2024-01-15",
        "aliases": [
          null
        ],
        "country": "usa",
        "id": 12345,
        "inactiveDate": "2024-01-15",
        "name": "Example Name",
        "nameTranslations": [
          "example"
        ],
        "overviewTranslations": [
          "example"
        ],
        "primaryCompanyType": 12345,
        "slug": "example-slug",
        "parentCompany": {
          "id": null,
          "name": null,
          "relation": null
        },
        "tagOptions": [
          null
        ]
      }
    ],
    "special_effects": [
      {
        "activeDate": "2024-01-15",
        "aliases": [
          null
        ],
        "country": "usa",
        "id": 12345,
        "inactiveDate": "2024-01-15",
        "name": "Example Name",
        "nameTranslations": [
          "example"
        ],
        "overviewTranslations": [
          "example"
        ],
        "primaryCompanyType": 12345,
        "slug": "example-slug",
        "parentCompany": {
          "id": null,
          "name": null,
          "relation": null
        },
        "tagOptions": [
          null
        ]
      }
    ]
  },
  "episodes": [
    {
      "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": [
        {
          "id": null,
          "image": null,
          "imageType": null,
          "lastUpdated": null,
          "name": null,
          "nameTranslations": null,
          "number": null,
          "overviewTranslations": null,
          "companies": null,
          "seriesId": null,
          "type": null,
          "year": null
        }
      ],
      "seriesId": 12345,
      "seasonName": "example",
      "year": "2024"
    }
  ],
  "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"
  ],
  "seriesId": 12345,
  "trailers": [
    {
      "id": 12345,
      "language": "eng",
      "name": "Example Name",
      "url": "https://artworks.thetvdb.com/banners/example.jpg",
      "runtime": 1
    }
  ],
  "type": {
    "alternateName": "example",
    "id": 12345,
    "name": "Example Name",
    "type": "example"
  },
  "tagOptions": [
    {
      "helpText": "example",
      "id": 12345,
      "name": "Example Name",
      "tag": 12345,
      "tagName": "example"
    }
  ],
  "translations": [
    {
      "aliases": [
        "example"
      ],
      "isAlias": true,
      "isPrimary": true,
      "language": "eng",
      "name": "Example Name",
      "overview": "A descriptive paragraph of text.",
      "tagline": "example"
    }
  ],
  "year": "2024"
}

Work with this as data

Every example 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 examples

4 MCP tools reach this
  • find_examplesBrowse and filter every example 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 example
curl "https://apis.io/api/v1/examples/tvdb-season-extended-record-example"
All examples
curl "https://apis.io/api/v1/examples?limit=25"

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

Get an API key

Free tier, no email required.

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