IMDb API: List a series' episodes (v1)

List one season of a series with each episode's title, air date, plot, rating and votes, 50 per page. A title without episodes returns is_series: false; an unknown title returns data: null.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

title_id_or_url*string

A series' title_id or imdb.com link, such as tt0903747 or https://www.imdb.com/title/tt0903747/.

Lengthlength <= 1000

season?integer

Season number. The response lists every season in seasons; some long-running shows number seasons by year.

Range1 <= value <= 9999

Default1

cursor?string

next_cursor from the previous page of the same request. Omit for the first page.

Lengthlength <= 2000

Default""

curl -X GET "https://example.com/v1/imdb/episodes?title_id_or_url=tt0903747" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "title_id": "tt0903747",    "title": "Breaking Bad",    "is_series": true,    "season": 1,    "seasons": [      1,      2,      3,      4,      5    ],    "total": 7,    "count": 0,    "has_more": true,    "next_cursor": "string",    "episodes": [      {        "title_id": "tt0959621",        "url": "https://www.imdb.com/title/tt0959621/",        "title": "Pilot",        "season": 1,        "episode": 1,        "release_date": "2008-01-20",        "runtime_minutes": 58,        "plot": "string",        "rating": 9.1,        "votes": 87347,        "image": {          "url": "https://m.media-amazon.com/images/M/MV5BMDAyY2FhYjctNDc5OS00MDNlLThiMGUtY2UxYWVkNGY2ZjljXkEyXkFqcGc@._V1_.jpg",          "width": 1200,          "height": 1800        }      }    ]  },  "details": {    "reason": "string",    "message": "string"  }}