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 UTC/GMT based and in the following format.

31 Oct 2024, 02:32 AM

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`

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

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 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)

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.`

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)

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.`

Step 3 : Generate Download Links

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.

Mirrored.to - Latest News & Updates