Api.Get.Episode_List::About

This API returns the complete episode list from a tv show based on an IMDB number.

Api.Get.Episode_List is a REST API reachable through HTTP GET requests.
Results are currently offered in two formats : JSON && XML.
We use MemCache to cache the resultset.

Need help ? contact us : api AT subtitleseeker.com .


Api.Get.Episode_List::Parameters

Api is accessible && working with HTTP GET requests at :

http://api.subtitleseeker.com/get/episode_list/
Parameter Value Notes
api_key [required] The Api key ,request Api Key
imdb [required] Imdb Number.
return_type [optional] Returned format :
  • xml [default]
  • json
gzip [optional] Gzip compression On/Off :
  • ON [default]
  • OFF

Take a look at some examples , responses or errors


Api.Get.Episode_List::Responses

Every valid request will return these basic parameters.
Take a look at the errors codes to process invalid requests.

Name Type Description
got_error int (0=valid|1=invalid). Is this query valid ?
seek string APi get category.( episode_list )
total_matches int total matches found
imdb int imdb number from [imdb]
items > item array Resultset for each match
page_generation_time int Page generation time in seconds

Item results


Every valid request with more then 0 total_matches will return these items.

Name Type Description
episode_id int Episode ID
episode_url string Link to episode Page
season int Season
episode int Episode
episode_number int Episode Number
episode_title string title of the episode.
airdate int Date episode first aired

Api.Get.Episode_List::Errors

Error codes are returned with an invalid request.
When parameter got_error is returned as 1

short msg
NO_API_KEY [api_key] Not set ! Get your api key at : api.subtitleseeker.com
API_KEY_INVALID [api_key] Api key does not seem to be valid. Wrong Key? Or Banned ? please contact api AT subtitleseeker.com
INVALID_IMDB_PARAMETER [imdb] required for episode_list. Imdb not set or invalid
INVALID_IMDB [imdb] is invalid. Does not exists in database.

Api.Get.Episode_List::Examples

Example 1 : Get episodes based on imdb number


You want to see all episodes from a title

Grab title episodes with IMDB number.
Imdb number can be found on imdb.com or by using our Api.Search

We will use "True Blood" as example.

URL XML :
http://api.subtitleseeker.com/get/episode_list/?api_key=API_KEY&imdb=0844441
URL JSON:
http://api.subtitleseeker.com/get/episode_list/?api_key=API_KEY&imdb=0844441&return_type=json