Archive for January, 2010

Kind of an API

Posted in New Features on January 13th, 2010 by Ivo Gomes – 12 Comments

Although we are still working on the new version of MyTVShows (wich has suffered a huge delay due to the lack of time we have to work on it), we are lauching (a kind of) an API.

It’s not a complete API, but just something to help you integrate MyTVShows in your own projects for the time being, that is, until we have something better…

It’s quite simple, go to your profile on MyTVShows and generate an API Key.
Then you can use the following URLs to get or post information:

To check if an episode is marked as seen or unseen
http://www.mytvshows.org/api/get_status/[API Key]/[show]/[season]/[episode]

To mark an episode as Seen
http://www.mytvshows.org/api/mark_seen/[API Key]/[show]/[season]/[episode]

To mark an episode as Unseen
http://www.mytvshows.org/api/mark_unseen/[API Key]/[show]/[season]/[episode]

To get the current episode rating
http://www.mytvshows.org/api/get_rating/[API Key]/[show]/[season]/[episode]

And finally, to rate an episode
http://www.mytvshows.org/api/rate/[API Key]/[show]/[season]/[episode]/[rating]

Please Note, the [show] must be the same name used on the show URL, for example:
http://www.mytvshows.org/show/bigbangtheory (The Big Bang Theory)

http://www.mytvshows.org/api/mark_seen/ABCD1234/bigbangtheory/4/4/

Warning: Never publish your API Key. This key allows marking episodes as seen/unseen on your account. So, to avoid that others can change the status of your episodes, you should keep this API Key private and only use it on services that you trust.