API Change

During an upgrade of our website, the API will also slightly change. Please read the migration guide and find the new API doc at: https://www.premiumize.me/static/api/migration.txt


This API can be used for the Premiumize.me Cloud. An active premium account is necessary.

Responses are json. Fields may be added, the order may change, but won't be removed without notice or change of the structure.

The response always contains a field "status" that will either contain "success" or "error". If the field value is "error", there will also be a field "message" with details.

All download and stream links (may contain redirects in the future)

IDs that are numeric (may become alphanumeric in the future)

back to top


Every request needs the paramters customer_id and pin, with the exception when a login cookie is present.

HTTPS is suggested but the API is also available without TLS under http://http.premiumize.me/.

back to top

User account information

Use https://www.premiumize.me/api/account/info

back to top

Cloud and files functions

API functions

All parameters can be GET or POST except the SRC parameter, wich must be a file if you want to upload a file. When sending data in production, please use POST.

You can always use our online file manager and look at the network activity in your browser development tools. It uses exactly the same API.

Creating a folder in the root folder

Use https://www.premiumize.me/api/folder/create?name=foldername

Creating a folder within a folder

Use https://www.premiumize.me/api/folder/create?parent_id=123&name=foldername

List the root folder

Use https://www.premiumize.me/api/folder/list

List a sub folder

Use https://www.premiumize.me/api/folder/list?id=64

Rename a folder

Use https://www.premiumize.me/api/folder/rename?id=64&name=newname

Move items into the root folder from somewhere else

Use https://www.premiumize.me/api/folder/paste?items=itemarray
Pass an array named "items" containing the elements to move.

itemarray: This should be a multidimensional array with items, containing two name fields. The first is "type", the other one is "id". Those values can be obtained from the folder list.

Move items into a folder from somewhere else

Use https://www.premiumize.me/api/folder/paste?id=targetfolderid&items=itemarray
You need to pass the id of the folder where you want to move to as paramter "id", the itemarray is constructed like above.

Delete a folder by its ID

Use https://www.premiumize.me/api/folder/delete?id=386

Delete an item

Use https://www.premiumize.me/api/item/delete?type=torrent&id=2525031

Browse the content of a finished torrent

Use https://www.premiumize.me/api/torrent/browse?hash=hash

The response should be self explanatory. The "transcoded" field for each video file will be null if the transcoding has not yet finished.

Once it has finished it will contain the necessary meta data.

If the transcoded field is null, it is necessary to hide the transcoded file from the user or use the direct link until it is ready.

Check torrent hashes against our cloud

Use https://www.premiumize.me/api/torrent/checkhashes?hashes[]=hash1&hashes[]=hash2&hashes[]=hash3

Start a download of a torrent

Use https://www.premiumize.me/api/transfer/create?type=torrent&src=SRC

Target folder is not supported, but the parameter will be named "folder_id".

SRC can be a posted file, a magnet link or a link to a .torrent file. Other types than "torrent" are not supported at the moment but will be soon.

This will also return a transfer type and ID after creation of the transfer.

In some cases the ID is the same as the hash.

Add the parameter "seed" with the value "2or48h" if you want to keep seeding the torrent. This will only have an effect on .torrent files from private trackers.

List current transfers

Use https://www.premiumize.me/api/transfer/list

Note: The most reliable would be to use "progress" which will be a float from 0 to 1 and "status" which will either be "waiting", "finished", "seeding", "timeout" or "error".

Clear finished transfers

Use https://www.premiumize.me/api/transfer/clearfinished

Delete or abort a transfer

Use https://www.premiumize.me/api/transfer/delete?type=torrent&id=id

Note: ID and type can be obtained from the tranfer list

back to top'

Bugreports, questions and help

Please reach out to our regular customer support. Your message will be forwarded to the technical department.


back to top