{"id":18464246,"url":"https://github.com/projectdiscovery/tldfinder","last_synced_at":"2025-04-04T16:14:21.246Z","repository":{"id":253300030,"uuid":"750431783","full_name":"projectdiscovery/tldfinder","owner":"projectdiscovery","description":"A streamlined tool for discovering private TLDs for security research.","archived":false,"fork":false,"pushed_at":"2025-03-24T12:44:18.000Z","size":469,"stargazers_count":180,"open_issues_count":4,"forks_count":5,"subscribers_count":11,"default_branch":"main","last_synced_at":"2025-03-28T15:07:36.853Z","etag":null,"topics":["tld-discovery","tldfinder"],"latest_commit_sha":null,"homepage":"","language":"Go","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/projectdiscovery.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}},"created_at":"2024-01-30T16:27:23.000Z","updated_at":"2025-03-05T18:30:02.000Z","dependencies_parsed_at":"2024-12-16T13:37:45.499Z","dependency_job_id":"24bb33ab-a9a6-4372-97e1-9f653c8c6c5f","html_url":"https://github.com/projectdiscovery/tldfinder","commit_stats":null,"previous_names":["projectdiscovery/tldfinder"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projectdiscovery%2Ftldfinder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projectdiscovery%2Ftldfinder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projectdiscovery%2Ftldfinder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projectdiscovery%2Ftldfinder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/projectdiscovery","download_url":"https://codeload.github.com/projectdiscovery/tldfinder/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247208145,"owners_count":20901570,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["tld-discovery","tldfinder"],"created_at":"2024-11-06T09:09:14.911Z","updated_at":"2025-04-04T16:14:21.222Z","avatar_url":"https://github.com/projectdiscovery.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\nTLDFinder\n\u003cbr\u003e\n\u003c/h1\u003e\n\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://opensource.org/licenses/MIT\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-_red.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://goreportcard.com/badge/github.com/projectdiscovery/tldfinder\"\u003e\u003cimg src=\"https://goreportcard.com/badge/github.com/projectdiscovery/tldfinder\"\u003e\u003c/a\u003e\n\u003ca href=\"https://pkg.go.dev/github.com/projectdiscovery/tldfinder/pkg/tldfinder\"\u003e\u003cimg src=\"https://img.shields.io/badge/go-reference-blue\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/projectdiscovery/tldfinder/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/release/projectdiscovery/tldfinder\"\u003e\u003c/a\u003e\n\u003ca href=\"https://twitter.com/pdiscoveryio\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/pdiscoveryio.svg?logo=twitter\"\u003e\u003c/a\u003e\n\u003ca href=\"https://discord.gg/projectdiscovery\"\u003e\u003cimg src=\"https://img.shields.io/discord/695645237418131507.svg?logo=discord\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e •\n  \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e •\n  \u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e •\n  \u003ca href=\"#running-tldfinder\"\u003eRunning tldfinder\u003c/a\u003e •\n  \u003ca href=\"https://discord.gg/projectdiscovery\"\u003eJoin Discord\u003c/a\u003e\n\u003c/p\u003e\n\nA streamlined tool for discovering private TLDs for security research.\n\n# Features\n\n![image](https://github.com/user-attachments/assets/f9c96de5-9a14-4861-a85a-21df8c848e76)\n\n - TLD based DNS lookups (Passive)\n - TLD based DNS lookups (Active)\n - STD **IN/OUT** and **TXT/JSON** output\n\n\n## Installation\n\ntldfinder requires **Go 1.21** to install successfully. To install, just run the below command or download pre-compiled binary from [release page](https://github.com/projectdiscovery/tldfinder/releases).\n\n```console\ngo install github.com/projectdiscovery/tldfinder/cmd/tldfinder@latest\n```\n\n## Usage\n\n```console\ntldfinder -h\n```\n\nThis will display help for the tool. Here are all the switches it supports.\n\n```console\nA streamlined tool for discovering private TLDs for security research.\n\nUsage:\n  ./tldfinder [flags]\n\nFlags:\nINPUT:\n   -d, -domain string[]  domain or list of domains for discovery (file or comma separated)\n\nSOURCE:\n   -s, -sources string[]           specific sources to use for discovery (-s censys,dnsrepo). Use -ls to display all available sources.\n   -es, -exclude-sources string[]  sources to exclude from enumeration (-es censys,dnsrepo)\n   -dm, -discovery-mode value      discovery mode (dns,tld,domain) (default dns)\n   -all                            use all sources for enumeration (slow)\n\nFILTER:\n   -m, -match string[]   domain or list of domain to match (file or comma separated)\n   -f, -filter string[]   domain or list of domain to filter (file or comma separated)\n\nRATE-LIMIT:\n   -rl, -rate-limit int      maximum number of http requests to send per second (global)\n   -rls, -rate-limits value  maximum number of http requests to send per second four providers in key=value format (-rls hackertarget=10/m) (default [\"waybackarchive=15/m\", \"whoisxmlapi=50/s\", \"whoisxmlapi=30/s\"])\n   -t int                    number of concurrent goroutines for resolving (-active only) (default 10)\n\nUPDATE:\n   -up, -update                 update tldfinder to latest version\n   -duc, -disable-update-check  disable automatic tldfinder update check\n\nOUTPUT:\n   -o, -output string       file to write output to\n   -oJ, -json               write output in JSONL(ines) format\n   -oD, -output-dir string  directory to write output (-dL only)\n   -cs, -collect-sources    include all sources in the output (-json only)\n   -oI, -ip                 include host IP in output (-active only)\n\nCONFIGURATION:\n   -config string                flag config file (default \"/Users/user/Library/Application Support/tldfinder/config.yaml\")\n   -pc, -provider-config string  provider config file (default \"/Users/user/Library/Application Support/tldfinder/provider-config.yaml\")\n   -r string[]                   comma separated list of resolvers to use\n   -rL, -rlist string            file containing list of resolvers to use\n   -nW, -active                  display active domains only\n   -proxy string                 http proxy to use with tldfinder\n   -ei, -exclude-ip              exclude IPs from the list of domains\n\nDEBUG:\n   -silent             show only domains in output\n   -version            show version of tldfinder\n   -v                  show verbose output\n   -nc, -no-color      disable color in output\n   -ls, -list-sources  list all available sources\n   -stats              report source statistics\n\nOPTIMIZATION:\n   -timeout int   seconds to wait before timing out (default 30)\n   -max-time int  minutes to wait for enumeration results (default 10)\n```\n\n## Running tldfinder\n\ntldfinder is designed for security research purposes to discover private TLDs. It accepts a domain or private TLD as input.\n\n- TLD Input: example (private TLD)\n- Domain Input: example.google (private TLD auto-extracted)\n\nUse `-domain` or `-d` to specify input, and provide multiple values as comma-separated input.\n\n\u003e [!NOTE]\n\u003e Only private TLDs are accepted, as tldfinder is meant for private TLD discovery.\n\n**Example run**:\n\n```console\n$ tldfinder -d google\n\n ________   ___  _____         __       \n/_  __/ /  / _ \\/ __(_)__  ___/ /__ ____\n / / / /__/ // / _// / _ \\/ _  / -_) __/\n/_/ /____/____/_/ /_/_//_/\\_,_/\\__/_/ \n\n      projectdiscovery.io\n\n[INF] Current tldfinder version v0.0.2 (latest)\n[INF] Enumerating sub(domains) for \"google\" TLD\nice.ext.google\ntest.postini.corp.google\nm.gutsdev.corp.google\norkut-impersonation.corp.google\norkut-qa.corp.google\nsites-googlegroups-qa07.corp.google\npartners.cloudskillsboost.google\nsupport.registry-sandbox.google\nwww.google\ndocs.google\nplus.google\ncache7.c.docs.google\nsmtp.google\n...\n[INF] Found 215 domains for google in 7 seconds 968 milliseconds\n```\n\n## Reference\n\n- [Hacking Beyond.com — Enumerating Private TLDs\n](https://cloud.google.com/blog/topics/threat-intelligence/enumerating-private-tlds/)\n\n\n## Acknowledgements\n\n- [N7WEra](https://github.com/N7WEra) for coming up with idea for this project.\n\n--------\n\n\u003cdiv align=\"center\"\u003e\n\ntldfinder is made with ❤️ by the [projectdiscovery](https://projectdiscovery.io) team and distributed under [MIT License](LICENSE).\n\n\n\u003ca href=\"https://discord.gg/projectdiscovery\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/projectdiscovery/nuclei-burp-plugin/main/static/join-discord.png\" width=\"300\" alt=\"Join Discord\"\u003e\u003c/a\u003e\n\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprojectdiscovery%2Ftldfinder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprojectdiscovery%2Ftldfinder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprojectdiscovery%2Ftldfinder/lists"}