API:GetSeries

From TvDBwiki

This interface allows you to find the id of a series based on its name.

[edit] Location

<mirrorpath>/api/GetSeries.php?seriesname=<seriesname> <mirrorpath>/api/GetSeries.php?seriesname=<seriesname>&language=<language>

[edit] Parameters

<seriesname>

This is the string you want to search for. If you search for "Lost", the first 10 series that include the word "Lost" in their name will be returned. If there is an exact match for the parameter, it will be the first result returned.

<language>

This is the abbreviation for the language you want to search in. If omitted, it will default to en (English). This may also be set to all, which will search ALL translations for <seriesname>.

[edit] Example Results

<?xml version="1.0" encoding="UTF-8" ?>
<Items>
  <Item>
     <seriesid>73739</seriesid>
     <language>no</language>
     <translation>Lost</translation>
  </Item>
  <Item>
     <seriesid>73739</seriesid>
     <language>it</language>
     <translation>Lost</translation>
  </Item>
  <Item>
     <seriesid>73739</seriesid>
     <language>de</language>
     <translation>Lost</translation>
  </Item>
  <Item>
     <seriesid>73739</seriesid>
     <language>en</language>
     <translation>Lost</translation>
  </Item>
  <Item>
     <seriesid>73739</seriesid>
     <language>nl</language>
     <translation>Lost</translation>
  </Item>
  <Item>
     <seriesid>71150</seriesid>
     <language>en</language>
     <translation>Lost at Home</translation>
  </Item>
  <Item>
     <seriesid>71177</seriesid>
     <language>en</language>
     <translation>Land of the Lost</translation>
  </Item>
  <Item>
     <seriesid>71225</seriesid>
     <language>en</language>
     <translation>Lost on Earth</translation>
  </Item>
  <Item>
     <seriesid>72906</seriesid>
     <language>en</language>
     <translation>Lost (2001)</translation>
  </Item>
  <Item>
     <seriesid>72923</seriesid>
     <language>en</language>
     <translation>Lost in Space</translation>
  </Item>
</Items>