Api.Get.Title_Subtitles::About

This API returns subtitles based on an IMDB number, release_id or episode_id.
You can sort on languages , seasons and episodes.

Api.Get.Title_Subtitles is a REST API reachable through HTTP GET requests.
Results are currently offered in two formats : JSON && XML.

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


Api.Get.Title_Subtitles::Parameters

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

http://api.subtitleseeker.com/get/title_subtitles/
Parameter Value Notes
api_key [required] The Api key ,request Api Key
imdb [required]
[optional]
Imdb Number. Optional if release_id or episode_id present.
release_id [optional]
[required]
Specify by release_id. Optional if imdb or episode_id present.
episode_id [optional]
[required]
Specify by episode_id. Optional if imdb or release_id present.
language [optional] Sort on languages.
Comma separated list ( for multiple )
max_results [optional] Number of maximum results returned :
  • 1
  • 10
  • 25 [default]
  • 50
  • 75
  • 100
order_by [optional] Order By

For tv shows:
  • 0 ( default ) - season/episode/added
  • downloads - order by popularity
  • added - order by last adition



For movies:
  • 0 ( default ) - popularity
  • added - order by last adition

season [optional] Specify season ( imdb required )
episode [optional] Specify episode ( imdb required )

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.Title_Subtitles::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.( title_info)
total_matches int total matches found
imdb int imdb number from [imdb]
release_id int number from [release_id]
episode_id int number from [episode_id]
order_by string orderd from [order_by]
languages string languages from [languages]
season int season from [season]
episode int episodes from [episode]
items > item array Resultset for each match
page_generation_time int Page generation time in seconds

Item results for Movies


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

Name Type Description
release string release name.
url string Link to subtitleseeker download
release_id int release ID
cd int number of cd's this release contains.
site string indexed site.
language string language of this release
added_unix int post date in unix time format
added_date int post date in date format
downloads int Number of downloads

Item results for Tv Shows


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

Name Type Description
release string release name.
url string Link to subtitleseeker download
episode_id int episode ID
season int season of this release.
episode int episode of this release.
episode_title string episode title of this release.
airdate int Date this episode first aired.
site string indexed site.
language string language of this release
added_unix int post date in unix time format
added_date int post date in date format
downloads int Number of downloads

Api.Get.Title_Subtitles::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_SORTID_PARAMETER [imdb] || [release_id] || [episode_id] required for title_subtitles SORT id not valid or missing
INVALID_IMDB [imdb] is invalid. Does not exists in database.
INVALID_RELEASE_ID [release_id] is invalid. Does not exists in database.
INVALID_EPISODE_ID [episode_id] is invalid. Does not exists in database
INVALID_SEASON [season] invalid , Needs either [imdb] or [episode_id]
INVALID_EPISODE [episode] invalid , Needs either [imdb] or [episode_id]

Api.Get.Title_Subtitles::Examples

Example 1 : Get subtitles based on imdb number


You want to see available subtitles for a title ordered by popularity.

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

We will use "The Dark Knight" as example.

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


Example 2 : Get subtitles based on release_id


You want to see available subtitles for a title ordered by popularity.

Grab title subtitles with release ID number.
release_id can be found by using either Api.Search or Api.Get.Title-Releases. We will use the release "The.Dark.Knight.2008.DvDrip-aXXo"

URL XML :
http://api.subtitleseeker.com/get/title_subtitles/?api_key=API_KEY&release_id=3819
URL JSON:
http://api.subtitleseeker.com/get/title_subtitles/?api_key=API_KEY&release_id=3819&return_type=json


Example 3 :Get subtitles with imdb number sorted by language(s)


You want to find subtitles from a title sorted by an specific language.
Imdb number can be found on imdb.com or by using our Api.Search

We will us as an example : "the dark knight" with languages English and Dutch.

URL XML :
http://api.subtitleseeker.com/get/title_subtitles/?api_key=API_KEY&imdb=0468569&language=English,Dutch
URL JSON:
http://api.subtitleseeker.com/get/title_subtitles/?api_key=API_KEY&imdb=0468569&language=English,Dutch&return_type=json


Example 4 : Get subtitles based on episode_id


Grab title subtitles with episode ID number.

episode_id can be found by using either Api.Search or Api.Get.Episode_List. We will use "True Blood " with season 4 episode 12 ( episode id = 708135 )

URL XML :
http://api.subtitleseeker.com/get/title_subtitles/?api_key=API_KEY&episode_id=708135
URL JSON:
http://api.subtitleseeker.com/get/title_subtitles/?api_key=API_KEY&episode_id=70813&return_type=json


Example 5 : Get subtitles episode based on imdb ,season and episode


Grab episode subtitles with imdb number , season and episode

Imdb number can be found on imdb.com or by using our Api.Search

We will use "True Blood " with season 4 episode 12 .

URL XML :
http://api.subtitleseeker.com/get/title_subtitles/?api_key=API_KEY&imdb=0844441&season=4&episode=12
URL JSON:
http://api.subtitleseeker.com/get/title_subtitles/?api_key=API_KEY&imdb=0844441&season=4&episode=12&return_type=json