simple-subdomain-finder 0.2.0

A free subdomain enumeration library using DNS queries, Common Crawl data, and optional Digital Yama API

simple-subdomain-finder

Simple Subdomain Finder is a subdomain enumeration library written in Python. Use it to get a list of subdomains that exist for a specified domain.

Simple Subdomain Finder does not break any website terms of service and is suitable for running at scale. Simple Subdomain Finder uses DNS queries, Common Crawl data, and the Digital Yama API (optional) to find and enumerate subdomains.

Usage

Installation

pip install simple-subdomain-finder

Basic

from simple_subdomain_finder import get_subdomains

results = get_subdomains("basspro.com")
print(results.subdomains)

Full

from simple_subdomain_finder import get_subdomains

results = get_subdomains("basspro.com", digitalyama_api_key="YOURAPIKEY")
print(results.subdomains)

Not A Scraper

Because Subdomain Finder doesn't attempt to scrape data from websites (eg. Google), Subdomain Finder can be used to enumerate subdomains for large batches of domains. To avoid exceeding the rate limits enforced by Common Crawl, it's recommended that you do not use async or threading to speed up requests.

Digital Yama API

You can optionally provide an API key from digitalyama.com to expand results using the Digital Yama Subdomain Finder API. Using the API will result in significantly more subdomains being found, including more hidden/non-obvious subdomains.

Subdomains List

This package includes a list of subdomains to scan for DNS records. The included list is a modified version of the n0kovo_subdomains list. You can use a different list by modifying the file subdomains_list.txt.