Skip to content
Fast, Elegant subdomain scanner using nodejs
Branch: master
Clone or download
Latest commit 19ac768 Jun 12, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
package-lock.json npm audit and add it to prepublish Jun 12, 2018


fast and elegant subdomain scanner built with node


To use subquest in your node scripts you have to install it and add it to your project dependencies:

npm install --save subquest

Than you can require it in your script and use it, following examples below.

After v1.5.0

After the version 1.5.0 the module doesn't use event emitters, just callbacks,

const subquest = require('subquest')

  host: ''
}, (err, results) => {

  if(err) {
    console.log('Error:', err);

  console.log('Subdomains:', results);  

Before v1.5.0

Before the version 1.5.0 the module makes use of event emitters to determine when it's done.

var subquest = require('subquest');

    host: '', // required
    rateLimit:'4', // four requests at time
    dnsServer:'', // custom DNS server
    dictionary: 'top_200' // dictionary file to use
  .on('end', function(res){
    console.log(res); // array of subdomains.

This scans for the list of all subdomains using the top_200 dictionary.


isValidDnsServer(server, [timeout], callback)

Test if a given address is valid DNS server

getResolvers([domain], callback)

Get the list of all the resolvers (DNS Servers) used in the scan, both default and custom


Get the list of the dictionary files used in the scan

getSubDomains(options, callback)

Run the scan against the domain to enumerate all subdomains

Looking for the cli version?

You can use subquest as a command line tool by cloning the official repository or using npm:

$ npm install -g subquest-cli

Want to add a new entry to Subquest's dictionary?

Add your list of subdomain names to the ./dictionary/all.txt file and send a pull request.


  1. Create an issue and describe your idea
  2. Fork the project (
  3. Create your feature branch (git checkout -b my-new-feature)
  4. Commit your changes (git commit -am 'Add some feature')
  5. Publish the branch (git push origin my-new-feature)
  6. Create a new Pull Request


You can’t perform that action at this time.