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.

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

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 :

---

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

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

---

Uploading Files

File Uploading is done in 3 steps. In the first step, you have to generate a unique upload_id which will be valid for two hours. In the second step, uploading (either local file upload by providing the file path or remote url upload by providing the remote URL) should be done to the upload URL provided in the first response. Once file uploading to our server is successful, the third step is to generate Mirrored.to/Mir.cr download link by providing the required list of mirrors. Steps are described below.

Step 1 : Get Upload Info

Get all the required details before an upload.
Endpoint

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 local file uploads	https://www.mirrored.to/api/v1/api_file_upload
remote_upload_url	URL to post for remote url 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]]

Step 2 : If Uploading by Posting a Local File (For Remote URL Uploading, See below)

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)

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.

Step 2 : If 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)

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.

Step 3 : Generate Download Links

Finish the upload process and generate download links.
Endpoint

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

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.