Aggregate Credits

This endpoint get the aggregate credits (cast and crew) that have been added to a TV show.

GET /tv/{series_id}/aggregate_credits

Aggregate Credits

cURL

curl --request GET \
  --url https://api.themoviedb.org/3/tv/{series_id}/aggregate_credits \
  --header 'Authorization: Bearer <token>'

200

{
  "cast": [
    {
      "adult": false,
      "gender": 2,
      "id": 94713,
      "known_for_department": "Acting",
      "name": "Warren Mitchell",
      "original_name": "Warren Mitchell",
      "popularity": 12.186,
      "profile_path": "/mMFruuo24m0A8LgVXjE6cUDrGFx.jpg",
      "roles": [
        {
          "credit_id": "5253853f19c295794020694c",
          "character": "Alf Garnett",
          "episode_count": 49
        }
      ],
      "total_episode_count": 49,
      "order": 0
    },
    {
      "adult": false,
      "gender": 1,
      "id": 87747,
      "known_for_department": "Acting",
      "name": "Dandy Nichols",
      "original_name": "Dandy Nichols",
      "popularity": 9.619,
      "profile_path": "/kOF7x205JqOyjwWkgAWzkMtQBcn.jpg",
      "roles": [
        {
          "credit_id": "5253853e19c29579402068ae",
          "character": "Else Garnett",
          "episode_count": 49
        }
      ],
      "total_episode_count": 49,
      "order": 1
    },
    {
      "adult": false,
      "gender": 1,
      "id": 1218303,
      "known_for_department": "Acting",
      "name": "Una Stubbs",
      "original_name": "Una Stubbs",
      "popularity": 24.373,
      "profile_path": "/bz23ewpBlZNgSwCLqKPaa8ulKfQ.jpg",
      "roles": [
        {
          "credit_id": "5253853f19c29579402068ea",
          "character": "Rita Rawlins",
          "episode_count": 49
        }
      ],
      "total_episode_count": 49,
      "order": 2
    },
    {
      "adult": false,
      "gender": 2,
      "id": 110455,
      "known_for_department": "Acting",
      "name": "Anthony Booth",
      "original_name": "Anthony Booth",
      "popularity": 5.771,
      "profile_path": "/qKdk7EFxFRkurP56fXmqkQqQlDm.jpg",
      "roles": [
        {
          "credit_id": "5253854019c295794020699c",
          "character": "Mike Rawlins",
          "episode_count": 49
        }
      ],
      "total_episode_count": 49,
      "order": 3
    },
    {
      "adult": false,
      "gender": 1,
      "id": 40949,
      "known_for_department": "Acting",
      "name": "Joan Sims",
      "original_name": "Joan Sims",
      "popularity": 13.65,
      "profile_path": "/zlqfbnRk85lAqt5ouKdA0JiQZRG.jpg",
      "roles": [
        {
          "credit_id": "6224aae3680be80044ff2797",
          "character": "",
          "episode_count": 5
        }
      ],
      "total_episode_count": 5,
      "order": 513
    },
    {
      "adult": false,
      "gender": 1,
      "id": 566324,
      "known_for_department": "Acting",
      "name": "Rita Webb",
      "original_name": "Rita Webb",
      "popularity": 8.931,
      "profile_path": "/wIOkZSyCEtweofGp1lu35rUBg3F.jpg",
      "roles": [
        {
          "credit_id": "5253853819c2957940206304",
          "character": "",
          "episode_count": 4
        }
      ],
      "total_episode_count": 4,
      "order": 509
    },
    {
      "adult": false,
      "gender": 2,
      "id": 3463,
      "known_for_department": "Acting",
      "name": "Roy Kinnear",
      "original_name": "Roy Kinnear",
      "popularity": 21.277,
      "profile_path": "/cuKguENjdEiNhNArAL5CqIaTEfE.jpg",
      "roles": [
        {
          "credit_id": "5253853919c29579402065ae",
          "character": "",
          "episode_count": 3
        }
      ],
      "total_episode_count": 3,
      "order": 508
    },
    {
      "adult": false,
      "gender": 1,
      "id": 3478,
      "known_for_department": "Acting",
      "name": "Pat Coombs",
      "original_name": "Pat Coombs",
      "popularity": 5.957,
      "profile_path": "/RpsQu7OP71FNGVKTMJtQTbSryc.jpg",
      "roles": [
        {
          "credit_id": "5253853819c2957940206458",
          "character": "",
          "episode_count": 3
        }
      ],
      "total_episode_count": 3,
      "order": 512
    },
    {
      "adult": false,
      "gender": 2,
      "id": 30119,
      "known_for_department": "Acting",
      "name": "Alfie Bass",
      "original_name": "Alfie Bass",
      "popularity": 6.213,
      "profile_path": "/1LnDvjwwtiQTrcaHGPDLsF9f3rq.jpg",
      "roles": [
        {
          "credit_id": "5253853b19c2957940206734",
          "character": "",
          "episode_count": 2
        }
      ],
      "total_episode_count": 2,
      "order": 500
    },
    {
      "adult": false,
      "gender": 1,
      "id": 12658,
      "known_for_department": "Acting",
      "name": "Patricia Hayes",
      "original_name": "Patricia Hayes",
      "popularity": 15.898,
      "profile_path": "/6XFwNMFX81TJOvY5k5V0rUANQL.jpg",
      "roles": [
        {
          "credit_id": "5253853b19c2957940206776",
          "character": "",
          "episode_count": 2
        }
      ],
      "total_episode_count": 2,
      "order": 502
    },
    {
      "adult": false,
      "gender": 2,
      "id": 29539,
      "known_for_department": "Acting",
      "name": "Spike Milligan",
      "original_name": "Spike Milligan",
      "popularity": 12.583,
      "profile_path": "/jnJjdXDPJaGWm7BSsTphqc48EoJ.jpg",
      "roles": [
        {
          "credit_id": "5253853919c2957940206540",
          "character": "",
          "episode_count": 1
        },
        {
          "credit_id": "6224aef43639090043524bcb",
          "character": "Paki-Paddy",
          "episode_count": 1
        }
      ],
      "total_episode_count": 2,
      "order": 506
    },
    {
      "adult": false,
      "gender": 2,
      "id": 86105,
      "known_for_department": "Acting",
      "name": "Bill Maynard",
      "original_name": "Bill Maynard",
      "popularity": 8.498,
      "profile_path": "/uU4i1l0jozXzXolhHkUoparSrM7.jpg",
      "roles": [
        {
          "credit_id": "6224ab23b84f94001dd96fde",
          "character": "",
          "episode_count": 1
        }
      ],
      "total_episode_count": 1,
      "order": 503
    },
    {
      "adult": false,
      "gender": 2,
      "id": 16275,
      "known_for_department": "Acting",
      "name": "Norman Bird",
      "original_name": "Norman Bird",
      "popularity": 18.779,
      "profile_path": "/gWimNB9CRJvE24vOeJbLpkxOi4q.jpg",
      "roles": [
        {
          "credit_id": "6224ab5b7c6de3006648e17c",
          "character": "",
          "episode_count": 1
        }
      ],
      "total_episode_count": 1,
      "order": 504
    },
    {
      "adult": false,
      "gender": 0,
      "id": 3454758,
      "known_for_department": "Acting",
      "name": "Alan Ball",
      "original_name": "Alan Ball",
      "popularity": 0.001,
      "profile_path": null,
      "roles": [
        {
          "credit_id": "6224ac3d680be8006dcab49e",
          "character": "",
          "episode_count": 1
        }
      ],
      "total_episode_count": 1,
      "order": 505
    },
    {
      "adult": false,
      "gender": 0,
      "id": 3454759,
      "known_for_department": "Acting",
      "name": "Martin Peters",
      "original_name": "Martin Peters",
      "popularity": 0.001,
      "profile_path": null,
      "roles": [
        {
          "credit_id": "6224ac4b4a52f80043170a61",
          "character": "",
          "episode_count": 1
        }
      ],
      "total_episode_count": 1,
      "order": 506
    },
    {
      "adult": false,
      "gender": 1,
      "id": 117549,
      "known_for_department": "Acting",
      "name": "Adrienne Posta",
      "original_name": "Adrienne Posta",
      "popularity": 11.056,
      "profile_path": "/w2ez8bH57d2kcIbK7D3eGi4ETSK.jpg",
      "roles": [
        {
          "credit_id": "6224aec046f354006dfea853",
          "character": "",
          "episode_count": 1
        }
      ],
      "total_episode_count": 1,
      "order": 510
    },
    {
      "adult": false,
      "gender": 2,
      "id": 575818,
      "known_for_department": "Acting",
      "name": "Hugh Lloyd",
      "original_name": "Hugh Lloyd",
      "popularity": 4.575,
      "profile_path": "/1kUCSbU7802Waqb6a2pI2p2cZwu.jpg",
      "roles": [
        {
          "credit_id": "6224b1477c6de3001b8a31b9",
          "character": "",
          "episode_count": 1
        }
      ],
      "total_episode_count": 1,
      "order": 514
    },
    {
      "adult": false,
      "gender": 2,
      "id": 140153,
      "known_for_department": "Acting",
      "name": "Bobby Moore",
      "original_name": "Bobby Moore",
      "popularity": 1.749,
      "profile_path": "/rlGl3WFHSjTJwqCUEekwwWCK2bN.jpg",
      "roles": [
        {
          "credit_id": "65ee61bfba131b017bac6fcc",
          "character": "Himself",
          "episode_count": 1
        }
      ],
      "total_episode_count": 1,
      "order": 515
    }
  ],
  "crew": [
    {
      "adult": false,
      "gender": 0,
      "id": 1218302,
      "known_for_department": "Production",
      "name": "Dennis Main Wilson",
      "original_name": "Dennis Main Wilson",
      "popularity": 0.772,
      "profile_path": null,
      "jobs": [
        {
          "credit_id": "5253853d19c29579402067a6",
          "job": "Director",
          "episode_count": 6
        }
      ],
      "department": "Directing",
      "total_episode_count": 6
    },
    {
      "adult": false,
      "gender": 0,
      "id": 1218302,
      "known_for_department": "Production",
      "name": "Dennis Main Wilson",
      "original_name": "Dennis Main Wilson",
      "popularity": 0.772,
      "profile_path": null,
      "jobs": [
        {
          "credit_id": "5253854019c29579402069e6",
          "job": "Producer",
          "episode_count": 49
        }
      ],
      "department": "Production",
      "total_episode_count": 49
    }
  ],
  "id": 550
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

series_id · integer · required

The session ID for tv.

Query Parameters

language · string

Defaults to en-US

Response

200 - application/json

Successful

cast · object[]

A collection of objects representing the actors who have appeared in the movie

Show child attributes

crew · object[]

A list of objects representing the behind-the-scenes staff who contributed to the production of the movie

Show child attributes

id · integer

A unique numerical identifier