GET

https://send.now/api/upload/url?key=key&url=url

Parameters Description Example Format Required
key API-Key 1ltghrilhllgrx2b2 STRING yes
url Remote url https://examples.com/file.zip STRING yes
folder Folder to put the file in (default: your root folder) 58 Number no

cURL example


curl --include \
'https://send.now/api/upload/url?key=1ltghrilhllgrx2b2&url=https://file-examples.com/file.zip'
          

Response


          {
            "result": {
              "file_code": "0rw8u8exqqte",
              "filecode": "0rw8u8exqqte"
            },
            "server_time": "2024-08-01 18:15:42",
            "msg": "OK",
            "status": 200
          }
          

Check the status

https://send.now/api/upload/urlstatus?key=1ltghrilhllgrx2b2&file_code=0rw8u8exqqte

          {
            "status": 200,
            "msg": "OK",
            "result": {
              "file_code": "0rw8u8exqqte",
              "status": "WORKING",
              "progress_percent": 42,
              "size_dl": 4404019,
              "size_full": 10485760
            },
            "server_time": "2024-08-01 18:15:50"
          }
          

When the download is finished the reply is "msg": "Upload completed successfully" and result has "status": "COMPLETED", the name, the size and download_url. Add &remove=1 to cancel a download that is still queued.

Notice

The server downloads the url in the background; the reply only confirms it was queued. Use the file code to follow it.
Only public http(s) addresses are accepted. Addresses inside a network (localhost, private and link-local IP addresses, internal host names) are refused with 400 "URL not allowed".
An API key is required: remote upload is not available to anonymous visitors.

Status code

200 Everything is OK. Request succeeded
400 Bad request (e.g. wrong parameters)
403 Permission denied
404 File not found
451 Unavailable