Kind of an API

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.

This entry was posted on Wednesday, January 13th, 2010 at 15:43 and is filed under New Features. You can follow any responses to this entry through the RSS 2.0 feed. You can leave a response, or trackback from your own site.

12 Comments

  1. dextro says:
    January 14, 2010 at 00:12

    So no way to list show unseen episodes or list shows you’re currently following?

  2. Ivo Gomes says:
    January 14, 2010 at 00:16

    Like I said, this is kind of an API. It’s just the basic thing: marking episodes ans seen/unseen and rating them. I’m not going to do much more right now because we are still working on a completely new version that will have it’s own API, with all the features a real API should have :)

  3. Karles23 says:
    January 14, 2010 at 09:36

    Do you have any approximate date for the start of the new version of MyTVShow? Thanks for the work!

  4. Ivo Gomes says:
    January 14, 2010 at 09:51

    I wish I had a date, but we don’t have much time to work on it right now.

  5. Karles23 says:
    January 14, 2010 at 09:58

    Thanks anyway, we will attentively waiting!

    :-)

  6. Luís Rebelo says:
    January 15, 2010 at 15:32

    Do you plan on having an iPhone App working with the API of the new site?

  7. Ivo Gomes says:
    January 15, 2010 at 15:41

    We have nothing planned for any iPhone App. We already have the iPhone version of the website that will probably be upgraded with the new features, but we haven’t tought of anything yet.

  8. Valinor4 says:
    January 20, 2010 at 18:59

    This might be a stupid question but are you looking for new developers to help you ?

  9. Ivo Gomes says:
    January 20, 2010 at 19:07

    Hello Valinor4.
    I’m not looking for developers. The team is composed by me and another developer, but we do have our day jobs and in the last few months we were overwhelmed with work and didn’t have the time to work on the website.

  10. guiglar says:
    February 6, 2010 at 17:10

    Hey I just tested the (kind of an) API and it returns an SQL error when the show name is invalid, with “OK” on the same page.
    I can work with that, but I wanted to let you know.

    Looking forward to the next API.
    o/

  11. Lk2 says:
    March 28, 2010 at 10:21

    There is more “hidden” API calls or there are only that? I’m thinking on build a free-program for Android plattform (I’m just started to learn how to develop for Android, give me a time! :D )

    Of course, I have read: this is a kind of an API :P

    Regards

  12. Maarten Ureel says:
    March 28, 2010 at 16:19

    Too bad there is no “get all unseen shows”, “get all shows” etc, but I’ll be sure to check out the new API when it’s released. I’m planning on making a Windows Mobile app for this :)

Leave a Reply