Api.Get.Title_Releases::About

This API returns the releases available for the movie and the number of subtitles each release contains based on an IMDB number.
It also returns the direct subtitleseeker URL for the title>release.
You can make an extra search query on a specific release/format/scenegroup.

Api.Get.Title_Releases 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_Releases::Parameters

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

http://api.subtitleseeker.com/get/title_releases/
Parameter Value Notes
api_key [required] The Api key ,request Api Key
imdb [required]
Imdb Number.
q [optional]
specify with a searchterm. Usually for group names.
max_results [optional] Number of maximum results returned :
  • 1
  • 10
  • 25 [default]
  • 50
  • 75
  • 100
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_Releases::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_releases)
total_matches int total matches found
imdb int imdb number from [imdb]
q string searchterm from [q]
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
release string release name.
release_id int release ID
total_subtitles int total subtitles for this release
release_url string Link to subtitleseeker release

Api.Get.Title_Releases::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 title_languages. Imdb not set or invalid .
INVALID_IMDB [imdb] is invalid. Does not exists in database.
INVALID_TITLE_REQUEST Releases are for movie titles ONLY.

Api.Get.Title_Releases::Examples

Example 1 : Get releases from Title


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

Grab title releases 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_releases/?api_key=API_KEY&imdb=0468569
URL JSON:
http://api.subtitleseeker.com/get/title_releases/?api_key=API_KEY&imdb=0468569&return_type=json


Example 2 :Find releases based on SCENE GROUP


You want to find releases from a title based on a search criteria.

Grab title releases 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.
We want to find all releases from AXXO for "The Dark Knight"
Q= -SCENEGROUP

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


Example 3 :Find releases based on other search terms


You want to find releases from a title based on a search criteria.

Grab title releases 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.
We want to find all "DvdRip" releases for "The Dark Knight"
Or your input can be :
- A complete release :"The.Dark.Knight.720p.BluRay.x264-iNFAMOUS"

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