× Upload Login/Sign up News & Updates Tools Help

API Documentation


An api_key is required to use our API. Please generate yours by visiting this link : https://www.mirrored.to/p/api

Mirrored.to offers a simple basic API which can be used to securely upload files to our website, view your account info and view information about the files uploaded. If you have any feature suggestions, questions regarding the usage or need any help, feel free to contact us.

Overview

API Path
Current API version is v1. All requests should be sent over HTTPS. All methods are done using POST unless otherwise stated.

https://www.mirrored.to/api/v1/

Date Format
All date/time are GMT based and in the following format.

25 Aug 2019, 11:31 PM

Response
All API response will be JSON encoded with appropriate HTTP status code. JSON response will contain status and message keys. Status will be either true or false. In case of a successful request, the message part will contain the required result either as an array of data or a string. In case of an unsuccessful request, the message part will contain the detailed error message.

Sample response of a request :

{"status":<true or false>,"message":"<Response message goes here>"}
 

Authentication

API Key
Each and every request must contain an api_key which is unique to your account. You can generate/update your api_key by visiting this link.

Daily API Calls Limit
Currently, you are allowed to make up to 500 API calls daily. If you wish to increase this limit for your account, please contact us

 

Get Account Info

Get details about your account.
Endpoint

https://www.mirrored.to/api/v1/get_account_info

Parameters

Name Description Example Required
api_key

Your API key

48ac563abaae8d4395237c540083e168

Yes

Response

Name Description Example
username

Your username

miruser
email

Your email

example@domain.com
join_date

Account creation time

02 Nov 2017, 05:33 PM
pro_user

If account is a PRO account

No
max_filesize

Maximum allowed file size in MB

500
max_mirrors

Maximum allowed mirrors

14
api_calls_remaining

Today's remaining API calls

473
 

File Upload

File Uploading is done in 3 steps. First, you have to generate a unique upload_id which will be valid for two hours. After that, uploading (either file or remote url) may be done to the URL provided in the first response. Once file uploading to our server is complete, the third step is to generate download link by providing the required list of mirrors. Steps are described below.

1. Get Upload Info

Get all the required details before an upload.
Endpoint

https://www.mirrored.to/api/v1/get_upload_info

Parameters

Name Description Example Required
api_key

Your API key

48ac563abaae8d4395237c540083e168

Yes

Response

Name Description Example
upload_id

Unique Upload ID to be used in all steps until link generation

79eadec9cea1b3e609a760fbccb42426
file_upload_url

URL to post for file uploads

https://www.mirrored.to/api/v1/api_file_upload
remote_upload_url

URL to post for remote uploads

https://www.mirrored.to/api/v1/api_remote_upload
upload_expiry

Entire uploading process must be completed before this expiry time

10 Mar 2019, 08:30 PM
max_filesize

Maximum allowed file size in MB for both file uploads and remote uploads

500
max_mirrors

Maximum allowed mirrors

14
available_mirrors

Array of all available mirrors list with maximum file size allowed for each

[["solidfiles",500],["bayfiles",500],["anonfile",500],["ddlto",500],["dlfreefr",500],["turbobit",500],["openload",500],["tusfiles",500],....,["rapidgator",500],["chomikujpl",500]]
default_mirrors

Array of default mirrors on our site with maximum file size allowed for each

[["solidfiles",500],["bayfiles",500],["anonfile",500],["ddlto",500]]
user_mirrors

Array of favorite hosts set by user in their Mirrored.to account

[["clicknupload",500],["uptobox",500],["dailyuploads",200],["wetransfer",500],["uploadednet",500]]

2a. Uploading by Posting a File

For file uploads, you may post the file to file_upload_url specified in the previous response and shall be multipart/form-data encoded. Other required parameters are api_key and upload_id. Please note that the size of the file must be lesser than or equal to the max_filesize or else your upload will result in an error.
Endpoint (Get it from file_upload_url in step 1)

https://www.mirrored.to/api/v1/api_file_upload

Parameters

Name Description Example Required
api_key

Your API key

48ac563abaae8d4395237c540083e168

Yes

upload_id

Unique Upload ID

79eadec9cea1b3e609a760fbccb42426

Yes

Filedata

File to upload

Yes

Response
On successful completion of upload, you'll get a success message after which you may proceed to step 3 to generate download link.

Name Description Example
message

Success Message

File successfully uploaded to our server. You may generate download URL by calling finish-upload api method and providing the mirrors list.

2b. Uploading by Posting a Remote URL

For remote URL uploads, you may post the URL to remote_upload_url specified in the first step. Other required parameters are api_key and upload_id. Please note that the size of the remote file must be lesser than or equal to the max_filesize or else your upload will result in an error.
Endpoint (Get it from remote_upload_url in step 1)

https://www.mirrored.to/api/v1/api_remote_upload

Parameters

Name Description Example Required
api_key

Your API key

48ac563abaae8d4395237c540083e168

Yes

upload_id

Unique Upload ID

79eadec9cea1b3e609a760fbccb42426

Yes

remote_url

Remote URL to upload

https://www.example.com/file.zip

Yes

Response
On successful completion of upload, you'll get a success message after which you may proceed to step 3 to generate download link.

Name Description Example
message

Success Message

File successfully uploaded to our server. You may generate download URL by calling finish-upload api method and providing the mirrors list.

3. Finish Upload

Finish the upload process and generate download links.
Endpoint

https://www.mirrored.to/api/v1/finish_upload

Parameters

Name Description Example Required
api_key

Your API key

48ac563abaae8d4395237c540083e168

Yes

upload_id

Unique Upload ID

79eadec9cea1b3e609a760fbccb42426

Yes

mirrors

List of comma separated mirrors to upload the file to. Names must exactly match with available_mirrors and the total number of mirrors should not exceed max_mirrors

solidfiles,anonfile,ddlto,zippyshare

Yes

password

If you wish to set a password to access the file, provide the password (optional)

P@ssw0rd

No

email

If provided, download link will be sent to this email id once the uploading process to all mirrors is complete (optional)

example@domain.com

No

Response

Name Description Example
file_id

File ID

ZXCV1234
full_url

Mirrored.to download link

https://www.mirrored.to/files/ZXCV1234/filename.zip_links
short_url

Mir.cr short link

https://mir.cr/ZXCV1234
 

Get File Info

Get details about a file.
Endpoint

https://www.mirrored.to/api/v1/get_file_info

Parameters

Name Description Example Required
api_key

Your API key

48ac563abaae8d4395237c540083e168

Yes

file_id

File ID

ZXCV1234

Yes

Response

Name Description Example
file_name

Name of the file

filename.zip
file_size

Size of the file

140 MB
upload_time

File upload time

02 Nov 2017, 05:33 PM
last_downloaded

Last download time

09 Mar 2019, 04:01 AM
password_protected

If the file is password protected

No

If the requested file_id is not available (that is, if the file is removed or does not exist), a 404 header code will be sent along with the status key in response as false.