2.1 Deprecation Notice!
Please be aware that the 2.1 version of our API has been deprecated. It has been replaced by v3. You can read the new API documentation here.

Media.addID

The Media.addID method allows you to add a file or disc id to the TMDb database. These file id's can be useful for identifying movies without having to worry about their file name.

We currently support 2 kinds of id's. More about these id's and hashes can be found here.

This is a POST method that needs a valid session key.

Example

http://api.themoviedb.org/2.1/Media.addID

Method parameters

• type

  Type can be xml, yaml or json. This will be the format of the response.

• api_key

  The API key we supplied you with for your account.

• session_key

  The session key you got via the authentication protocol.

• id

  The ID of the TMDb movie you are tagging with the hash. Expected value is an integer.

• media_id

  This is the computed id (hash) from the methods outlined above. Expected value is a string.

• media_type

  One of the two suppoorted types; file and dvd. Expected value is a string.

• total_size

  Byte size of the file you are hashing.

• fps

  The fps of the content you are id'ing. Expected value is a float.

• volume_label

  If you're posting a disc ID, save the volume label. This is the only optional parameter. Expected value is a string.

Authentication & Access

This service requires authentication. Please see the authentication basics page for more information.

Since this is a write service, it must be accessed with an HTTP POST request.

Example Response

<?xml version="1.0" encoding="UTF-8"?>
<OpenSearchDescription xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/">
  <status>
    <code>1</code>
    <status>Success</status>
  </status>
</OpenSearchDescription>