<div align="center">
<img src="logo.png" style="width: 200px; hight: 200px;"/>
<h2>TLDX</h2>
<p>Top Level Domain(TLD) Expansion Tool for Bug Bounty</p>
</div>
---
Expand keywords across all TLDs to discover hidden assets during reconnaissance.
### Features
- Generate domain permutations (keyword + TLD)
- Supports single keywords or keyword files
- Uses official IANA TLD list
- Custom TLD lists support
- Output to console or file
### Installation
```bash
pip install tldx
```
### Usage
```yaml
# Single keyword
tldx -k google
# Keyword file
tldx -kf keywords.txt
# Save output
tldx -k admin -o targets.txt
# Custom TLD list
tldx -k test -t custom_tlds.txt
# Verbose mode
tldx -k dev -v
```
### Example
```yaml
# Generate government domains
tldx -k google | head -5
google.aaa
google.aarp
google.abb
google.abbott
google.abbvie
# Pipe to DNS resolver
tldx -k "api.google" | dnsx -silent
# Full recon workflow
tldx -kf keywords.txt | httpx -silent | nuclei -t vulnerabilities/
```
```yaml
tldx/
├── setup.py
├── requirements.txt
├── README.md
├── tldx/
│ ├── __init__.py
│ ├── cli.py
│ └── core.py
└── tests/
└── test_tldx.py
```
Raw data
{
"_id": null,
"home_page": "https://github.com/LocaMartin/tldx",
"name": "tldx",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "bugbounty recon tld security",
"author": "Loca Martin",
"author_email": "locaboyff@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/9c/af/9cd057b3239d0f37d5b2bc6efebb218e4e41fe90bc02460d31b380c8eb82/tldx-1.0.1.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n<img src=\"logo.png\" style=\"width: 200px; hight: 200px;\"/>\n<h2>TLDX</h2>\n<p>Top Level Domain(TLD) Expansion Tool for Bug Bounty</p>\n</div>\n\n---\nExpand keywords across all TLDs to discover hidden assets during reconnaissance.\n\n### Features\n- Generate domain permutations (keyword + TLD)\n- Supports single keywords or keyword files\n- Uses official IANA TLD list\n- Custom TLD lists support\n- Output to console or file\n\n### Installation\n```bash\npip install tldx\n```\n### Usage\n```yaml\n# Single keyword\ntldx -k google\n\n# Keyword file\ntldx -kf keywords.txt\n\n# Save output\ntldx -k admin -o targets.txt\n\n# Custom TLD list\ntldx -k test -t custom_tlds.txt\n\n# Verbose mode\ntldx -k dev -v\n```\n### Example\n\n```yaml\n# Generate government domains\ntldx -k google | head -5\ngoogle.aaa\ngoogle.aarp\ngoogle.abb\ngoogle.abbott\ngoogle.abbvie\n\n# Pipe to DNS resolver\ntldx -k \"api.google\" | dnsx -silent\n\n# Full recon workflow\ntldx -kf keywords.txt | httpx -silent | nuclei -t vulnerabilities/\n```\n\n```yaml\ntldx/\n\u251c\u2500\u2500 setup.py\n\u251c\u2500\u2500 requirements.txt\n\u251c\u2500\u2500 README.md\n\u251c\u2500\u2500 tldx/\n\u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u251c\u2500\u2500 cli.py\n\u2502 \u2514\u2500\u2500 core.py\n\u2514\u2500\u2500 tests/\n \u2514\u2500\u2500 test_tldx.py\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "TLD Expansion Tool for Bug Bounty Reconnaissance",
"version": "1.0.1",
"project_urls": {
"Homepage": "https://github.com/LocaMartin/tldx"
},
"split_keywords": [
"bugbounty",
"recon",
"tld",
"security"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "5d62b7bf8aa8f0016d87dbc73c1f08a9a88284f30b7a5c37d4f7c15f770f8533",
"md5": "4ae0df66c9405b6d783fbf5c14a0dce7",
"sha256": "f87c01d906439fcaeee5536399d5b13ae0ddb6880e83a4cd9013de257cbe5672"
},
"downloads": -1,
"filename": "tldx-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4ae0df66c9405b6d783fbf5c14a0dce7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 3857,
"upload_time": "2025-07-16T08:20:10",
"upload_time_iso_8601": "2025-07-16T08:20:10.158426Z",
"url": "https://files.pythonhosted.org/packages/5d/62/b7bf8aa8f0016d87dbc73c1f08a9a88284f30b7a5c37d4f7c15f770f8533/tldx-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "9caf9cd057b3239d0f37d5b2bc6efebb218e4e41fe90bc02460d31b380c8eb82",
"md5": "18c68f29a6cde1f781aee1bbf0fe73c5",
"sha256": "61e20582674b8314c07226a28bb9b72008ca8a50273b0e8621f72a6616e653aa"
},
"downloads": -1,
"filename": "tldx-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "18c68f29a6cde1f781aee1bbf0fe73c5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 4099,
"upload_time": "2025-07-16T08:20:12",
"upload_time_iso_8601": "2025-07-16T08:20:12.075792Z",
"url": "https://files.pythonhosted.org/packages/9c/af/9cd057b3239d0f37d5b2bc6efebb218e4e41fe90bc02460d31b380c8eb82/tldx-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-16 08:20:12",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "LocaMartin",
"github_project": "tldx",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "requests",
"specs": [
[
">=",
"2.25.1"
]
]
}
],
"lcname": "tldx"
}
JSON
