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>
