General

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

Authentification

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=SEEBELOW
You need to pass the id of the folder where you want to paste to as paramter "id". Then you pass an array named "items" containing the elements to paste. The elements should have the fields "id" and "type" to identify them.

Move items into a folder from somewhere else

Try: https://www.premiumize.me/api/folder/paste?items=SEEBELOW

Items: 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.

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.

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.

www.premiumize.me/help

Zurück