Nurlresolver NPM

nurlresolver

Streamline your download experience with this Node.js package designed to extract direct, hassle-free downloadable links from various file-sharing websites. Say goodbye to multiple clicks and pesky ads, ensuring a seamless and efficient downloading process.

Live Demo

Warning: This package is native ESM and no longer provides a CommonJS export. If your project uses CommonJS, you will have to convert to ESM or use the dynamic import() function. Please don't open issues for questions regarding CommonJS / ESM.

Installation

npm install nurlresolver

Usage: ES6 usage

import nUrlResolver from 'nurlresolver';
const results = await nUrlResolver.resolve(linkToResolve);

const linkToResolve = 'https://cloud.mail.ru/public/abcd/sAmPlE';
const results = await nUrlResolver.resolve(linkToResolve);

Output

[  
  {
    link: 'https://cloclo3.cldmail.ru/public/get/generatedlink/no/FileName.extension',
    title: 'FileName.extension',
    isPlayable: true,
    parent: 'https://cloud.mail.ru/public/abcd/sAmPlE',
    speedRank: 65 //0-100 better speed means higher rank
  }
]

Resolve link recursively:

const results = await nUrlResolver.resolveRecursive(link);
/*
This is going to resolve the final playback links.
Schema representation is same as above result.
The only difference is it recursively resolve all the links as they get found.
*/

Headers Support

In some of the sharing sites, it's required to send some header information back. e.g. Referer is required in some sites or if a link generated from an ip which is only accessible from that ip (in this case the xforward header is added in the result output so that same header can be sent to the same site later on.)

Advance Options

options

Name	Type	Description
extractMetaInformation	boolean	instruct the resolver to extract contenttype, lastmodifieddate and size of the file.
timeout	number	timeout in seconds
googleDrive.apiKey	string	optional api key to avoid anonymous access. Defaults to empty to allow anonymous access.
customResolvers	array	custom resolvers you can inject for resolving urls. Refer to app.tests for implementation samples

const results = await nUrlResolver.resolve(linkToResolve, {
    extractMetaInformation: true,
    timeout: 30 //returns the results at maximum after 30 seconds.
});

Output

[
  {
    "link": "http://www5d.filecdn.pw/dkske911881kkk?download_token=SOME_TOKEN_VALUE",
    "title": "FILE.EXTENSION",
    "isPlayable": true,
    "headers": {
      "X-Real-IP": "XX.YY.ZZ.AA"
    },
    "parent": "https://dlfiles.online/dkske911881kkk",
    "speedRank": 55,
    "size": "900163682",
    "lastModified": "Wed, 21 Sep 2019 12:09:06 GMT",
    "contentType": "application/octet-stream"
  }
]

Supported sites