{"id":51038945,"url":"https://github.com/ipmartnetwork/subdomainfinder","last_synced_at":"2026-06-22T09:01:26.540Z","repository":{"id":310601312,"uuid":"797796009","full_name":"iPmartNetwork/SubDomainFinder","owner":"iPmartNetwork","description":null,"archived":false,"fork":false,"pushed_at":"2024-05-08T14:47:20.000Z","size":28,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-29T01:25:04.642Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iPmartNetwork.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-05-08T14:30:46.000Z","updated_at":"2024-06-06T17:26:34.000Z","dependencies_parsed_at":"2025-08-19T06:19:11.679Z","dependency_job_id":"f31d7e5c-2222-4881-9e64-2e23c0d90bfe","html_url":"https://github.com/iPmartNetwork/SubDomainFinder","commit_stats":null,"previous_names":["ipmartnetwork/subdomainfinder"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/iPmartNetwork/SubDomainFinder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iPmartNetwork%2FSubDomainFinder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iPmartNetwork%2FSubDomainFinder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iPmartNetwork%2FSubDomainFinder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iPmartNetwork%2FSubDomainFinder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iPmartNetwork","download_url":"https://codeload.github.com/iPmartNetwork/SubDomainFinder/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iPmartNetwork%2FSubDomainFinder/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34641636,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-22T02:00:06.391Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-22T09:01:24.758Z","updated_at":"2026-06-22T09:01:26.529Z","avatar_url":"https://github.com/iPmartNetwork.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n\u003cpicture\u003e\n\u003cimg width=\"160\" height=\"160\"  alt=\"XPanel\" src=\"https://github.com/iPmartNetwork/iPmart-SSH/blob/main/images/logo.png\"\u003e\n\u003c/picture\u003e\n  \u003c/p\u003e \n\u003cp align=\"center\"\u003e\n\u003ch1 align=\"center\"/\u003eSubDomainFinder\u003c/h1\u003e\n\u003ch6 align=\"center\"\u003eSubDomainFinder\u003ch6\u003e\n\u003c/p\u003e\n\n\n## SubDomainFinder\n\nSubDomainFinder is a tool designed to find hidden subdomains and secrets present is either webpage, Github, and external javascripts present in the given URL.\nThis tool also finds S3 buckets, cloudfront URL's and more from those JS files which could be interesting like S3 bucket is open to read/write, or subdomain takeover and similar case for cloudfront.\nIt also scans inside given folder which contains your files.\n\n## Cloud Storage Services Supported:\nSubDomainFinder can find URL's for following cloud storage services:\n```\n1. Amazon AWS services (cloudfront and S3 buckets)\n2. Digitalocean spaces \n3. Microsoft Azure \n4. Google Cloud Services \n5. Dreamhost \n6. RackCDN. \n```\n## Secret Key's Searching: (beta)\nSubDomainFinder will also find secrets present in content of the page and javascripts files.\nThose secret finding depends on some specific keywords and *Shannon Entropy* formula.\nIt might be possible that some secrets which searched by tool will be false positive.\nThis secret key searching is in beta and later version might have increased accuracy for search results.\n\n\n## Installation Steps\n\n1. Clone SubDomainFinder from git:\n```\ngit clone https://github.com/ipmartnetwork/SubDomainFinder.git\n```\n2. Change the directory:\n```\ncd SubDomainFinder\n```\n\n3. Install the requirements:\n\n```\npip3 install -r requirements.txt\n```\n4. Enjoy the Tool.\n\n\n\n## Usage\n\nShort Form    | Long Form     | Description\n------------- | ------------- |-------------\n-u            | --url         | URL in which you want to find (sub)domains.\n-l            | --listfile    | File which contain list of URL's needs to be scanned.\n-o            | --output      | Output file name in which you need to save the results.\n-c            | --cookie      | Cookies which needs to be sent with request.\n-h            | --help        | show the help message and exit.\n-cop          | --cloudop     | Give file name in which you need to store cloud services results.\n-d            | --domains     | Give TLD (eg. for www.example.com you have to give example.com) to find subdomain for given TLD seperated by comma (no spaces b/w comma).\n-g            | --gitscan     | Needed if you want to get things via Github too.\n-gt           | --gittoken    | Github API token is needed, if want to scan (also needed -g also).\n-gop\t      | --gitsecretop | Saving secrets to a file found in github.\n-k            | --nossl       | Use this to bypass the verification of SSL certificate.\n-f            | --folder      | Root folder which contains files/folder.\n-san          | --subject_alt_name    |  Find Subject Alternative Names for all found subdomains, Options: 'all', 'same'.\n\n## SAN options description:\n* all - This option will find all domains and subdomains.\n* same - This will only find subdomains for specific subdomains.\n\n## Examples\n\n* To list help about the tool:\n```\npython3 SubDomainFinder.py -h\n```\n* To find subdomains, s3 buckets, and cloudfront URL's for given single URL:\n```\npython3 SubDomainFinder.py -u http://www.example.com\n```\n* To find subdomains from given list of URL (file given):\n```\npython3 SubDomainFinder.py -l list.txt\n```\n\n* To save the results in (output.txt) file:\n```\npython3 SubDomainFinder.py -u https://www.example.com -o output.txt\n```\n* To give cookies:\n```\npython3 SubDomainFinder.py -u https://www.example.com -c \"test=1; test=2\"\n```\n* To scan via github:\n```\npython3 SubDomainFinder.py -u https://www.example.com -o output.txt -gt \u003cgithub_token\u003e -g \n```\n* No SSL Certificate Verification:\n```\npython3 SubDomainFinder.py -u https://www.example.com -o output.txt -gt \u003cgithub_token\u003e -g  -k\n```\n* Folder Scanning:\n```\npython3 SubDomainFinder.py -f /path/to/root/folder/having/files/and/folders/  -d example.com  -gt \u003cgithub_token\u003e -g  -k\n```\n* Subject Alternative Names:\n```\npython3 SubDomainFinder.py -u https://www.example -san all\n```\n* Saving secrets to a file scan found in github:\n```\npython3 SubDomainFinder.py -u https://www.example.com -o output.txt -gt \u003cgithub_token\u003e -g -gop filename_to_save\n```\n\n\n# تلگرام\n\n[@ipmart_network](https://t.me/ipmart_network)\n\n[@iPmart Group](https://t.me/ipmartnetwork_gp)\n\n\n\n\n # حمایت از ما :hearts:\nحمایت های شما برای ما دلگرمی بزرگی است\u003cbr\u003e \n\u003cp align=\"left\"\u003e\n\u003ca href=\"https://plisio.net/donate/kB7QU7f7\" target=\"_blank\"\u003e\u003cimg src=\"https://plisio.net/img/donate/donate_light_icons_mono.png\" alt=\"Donate Crypto on Plisio\" width=\"240\" height=\"80\" /\u003e\u003c/a\u003e\u003cbr\u003e\n\t\n|                    TRX                   |                       BNB                         |                    Litecoin                       |\n| ---------------------------------------- |:-------------------------------------------------:| -------------------------------------------------:|\n| ```TJbTYV1fFo2485sYMyajxGPLFzxmNmPrNA``` |  ```0x4af3de9b303a8d43105e284823d95b4c600961a3``` | ```MPrkzFiNtw4Rg67bbZB6gCxa9LV87orABM``` |\t\n\n\u003c/p\u003e\t\n\n\n\n\n\u003cp align=\"center\"\u003e\n\u003cpicture\u003e\n\u003cimg width=\"160\" height=\"160\"  alt=\"XPanel\" src=\"https://github.com/iPmartNetwork/iPmart-SSH/blob/main/images/logo.png\"\u003e\n\u003c/picture\u003e\n  \u003c/p\u003e \n\n  \n  \n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fipmartnetwork%2Fsubdomainfinder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fipmartnetwork%2Fsubdomainfinder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fipmartnetwork%2Fsubdomainfinder/lists"}