API

The My Movies Collection "so called" API is a very simple interface developers can use to integrate My Movies Collection into their applications.

Very few methods are available for the time been, but we're glad to ear from you regarding new methods you may need. Also, if you integrated our API into your project, please let us know

All the movie titles, images and all other details are responsability and have reserved rights by their owners and/or authors.

API usage

The API should be called using HTTP GET requests at the following URL:

http://mymoviescollection.net/api/

Two parameters are always required: the user API Key (which can be obtained in the user profile) and the Method:

http://mymoviescollection.net/api/[api key]/[method]/

Available methods

Collection listing | Checking seen/unseen status | Mark as seen

Collection listing: "list"

This method allows you to get the entire collection list of the user. No other parameters are required or even allowed:

http://mymoviescollection.net/api/[api key]/list/

If everything is OK you'll get a error status of 0 (zero) and a XML list of the collection:

<?xml version="1.0" encoding="UTF-8" ?>
<api>
  <status>
    <errcode>0</errcode>
    <description>OK</description>
  </status>
  <movies>
    <movie>
      <global_ref>109</global_ref>
      <format_ref>49</format_ref>
      <format>
        <id_format>1</id_format>
        <description><![CDATA[DVD]]></description>
      </format>
      <imdb_id>tt0133093</imdb_id>
      <title><![CDATA[The Matrix]]></title>
      <year>1999</year>
      <seen>1260699167</seen>
    </movie>
    <movie>
      (...)
    </movie>
    (...)
</movies>
</api>

The status section is where you'll get error codes and descriptions, if there are any errors.

In the movies section you'll get the collection list in several movie sections, with the following fields:

  • global_ref: The global reference for this item on the user collection;
  • format_ref: The global reference for this item on the user collection;
  • format / id_format: A unique identifier on our database for the format this item is owned;
  • format / description: The format this item is owned (wrapped in CDATA);
  • imdb_id: The IMDb ID for this item;
  • title: The name of this item (wrapped in CDATA);
  • year: The release year;
  • seen: Unix timestamp (GMT) of the time this item was marked as seen. 0 (zero) if the item is not marked as seen.

Checking seen/unseen status: "seenstatus"

This method allows you to check if a specific Movie or TV Show episode is marked as seen.

The following parameters can be used:

  • imdb_id (required, string): The IMDb ID of the item we're checking the seen status (including leading tt);
  • season (optional, integer): The season number. If we're trying to check for an episode (just for users who have choosen to manage tv shows episodes), or the entire season status;
  • episode (optional, integer): The episode number. If we're trying to check for an episode (just for users who have choosen to manage tv shows episodes).

http://mymoviescollection.net/api/[api key]/seenstatus/[imdb id]/[season]/[episode]/

If everything is OK you'll get a error status of 0 (zero) and a XML list of the Movies/Episodes:

<?xml version="1.0" encoding="UTF-8" ?>
<api>
  <status>
    <errcode>0</errcode>
    <description>OK</description>
  </status>
  <movies>
    <movie>
      <global_ref>110</global_ref>
      <format_ref>50</format_ref>
      <format>
        <id_format>1</id_format>
        <description><![CDATA[DVD]]></description>
      </format>
      <imdb_id>tt0412142</imdb_id>
      <title><![CDATA[House M.D.]]></title>
      <season>3</season>
      <episode>4</episode>
      <seen>1260699168</seen>
    </movie>
    <movie>
      (...)
    </movie>
    (...)
</movies>
</api>

In the movies section you'll get the items returned in several movie sections, with some fields equal to the ones you find on the list method plus:

  • season: For TV Shows only, the season;
  • episode: For TV Shows only, the episode;
  • seen: Unix timestamp (GMT) of the time this item was marked as seen. 0 (zero) if the item is not marked as seen.

Mark as seen: "markseen"

This method allows you to mark a specific Movie or TV Show episode as seen.

The following parameters can be used:

  • imdb_id (required, string): The IMDb ID of the item we're marking as seen (including leading tt);
  • season (optional, integer): The season number. If we're trying to mark an episode (just for users who have choosen to manage tv shows episodes), or the entire season as seen (just for users who have NOT choosen to manage tv shows episodes);
  • episode (optional, integer): The episode number. If we're trying to mark an episode as seen (just for users who have choosen to manage tv shows episodes).

http://mymoviescollection.net/api/[api key]/markseen/[imdb id]/[season]/[episode]/

PLEASE NOTE that EVERY item in the user collection that matches the provided IMDb ID, Season and Episode, will be marked as seen if they weren't until this moment. As an example, if the user has two unseen copies of the same Movie/Episode in different formats, they'll both be marked as seen.

If everything is OK you'll get a error status of 0 (zero) and a XML list of the Movies/Episodes:

<?xml version="1.0" encoding="UTF-8" ?>
<api>
  <status>
    <errcode>0</errcode>
    <description>OK</description>
  </status>
  <movies>
    <movie>
      <global_ref>110</global_ref>
      <format_ref>50</format_ref>
      <format>
        <id_format>1</id_format>
        <description><![CDATA[DVD]]></description>
      </format>
      <imdb_id>tt0412142</imdb_id>
      <title><![CDATA[House M.D.]]></title>
      <season>6</season>
      <episode>2</episode>
      <seen>1260699169</seen>
    </movie>
    <movie>
      (...)
    </movie>
    (...)
</movies>
</api>

In the movies section you'll get the items marked as seen in several movie sections, with some fields equal to the ones you find on the list method plus:

  • season: For TV Shows only, the season;
  • episode: For TV Shows only, the episode;
  • seen: Unix timestamp (GMT) of the time this item was marked as seen (now).
2010-2014, My Movies Collection
Development: Webdados, Lda. | Hosting: ptAlojamento | Logo: Sérgio Alves | Movies data: themoviedb.org | TV Shows data: TheTVDB.com
All the movie titles, images and all other details are responsability and have reserved rights by their owners and/or authors.