{"id":13574133,"url":"https://github.com/gwen001/github-subdomains","last_synced_at":"2025-04-12T18:49:38.424Z","repository":{"id":37388114,"uuid":"282146002","full_name":"gwen001/github-subdomains","owner":"gwen001","description":"Find subdomains on GitHub.","archived":false,"fork":false,"pushed_at":"2023-03-28T15:47:06.000Z","size":49244,"stargazers_count":712,"open_issues_count":7,"forks_count":105,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-04-03T22:07:42.760Z","etag":null,"topics":["bugbounty","github","go","golang","pentesting","security-tools","subdomains"],"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/gwen001.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null},"funding":{"github":["gwen001"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2020-07-24T06:54:29.000Z","updated_at":"2025-03-30T05:47:55.000Z","dependencies_parsed_at":"2024-01-14T03:51:20.385Z","dependency_job_id":"c781d63d-0183-4a00-971f-b13510bd4ac7","html_url":"https://github.com/gwen001/github-subdomains","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gwen001%2Fgithub-subdomains","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gwen001%2Fgithub-subdomains/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gwen001%2Fgithub-subdomains/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gwen001%2Fgithub-subdomains/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gwen001","download_url":"https://codeload.github.com/gwen001/github-subdomains/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248618218,"owners_count":21134199,"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":["bugbounty","github","go","golang","pentesting","security-tools","subdomains"],"created_at":"2024-08-01T15:00:46.923Z","updated_at":"2025-04-12T18:49:38.400Z","avatar_url":"https://github.com/gwen001.png","language":"Go","readme":"\u003ch1 align=\"center\"\u003egithub-subdomains\u003c/h1\u003e\n\n\u003ch4 align=\"center\"\u003eFind subdomains on GitHub.\u003c/h4\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/go-v1.13-blue\" alt=\"go badge\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/license-MIT-green\" alt=\"MIT license badge\"\u003e\n    \u003ca href=\"https://twitter.com/intent/tweet?text=https%3a%2f%2fgithub.com%2fgwen001%2fgithub-subdomains%2f\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/twitter/url?style=social\u0026url=https%3A%2F%2Fgithub.com%2Fgwen001%2Fgithub-subdomains\" alt=\"twitter badge\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003c!-- \u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/stars/gwen001/github-subdomains?style=social\" alt=\"github stars badge\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/watchers/gwen001/github-subdomains?style=social\" alt=\"github watchers badge\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/forks/gwen001/github-subdomains?style=social\" alt=\"github forks badge\"\u003e\n\u003c/p\u003e --\u003e\n\n---\n\n## Description\n\nThis Go tool performs searches on GitHub and parses the results to find subdomains of a given domain.\n\n## Install\n\n```\ngo install github.com/gwen001/github-subdomains@latest\n```\n\nor\n\n```\ngit clone https://github.com/gwen001/github-subdomains\ncd github-subdomains\ngo install\n```\n\n## Usage\n\n```\n$ github-subdomains -h\n\nUsage of github-subdomains:\n  -d string\n    \tdomain you are looking for (required)\n  -e\textended mode, also look for \u003cdummy\u003eexample.\u003ctld\u003e\n  -k\texit the program when all tokens have been disabled\n  -o string\n    \toutput file, default: \u003cdomain\u003e.txt\n  -raw\n    \traw output\n  -t string\n    \tgithub token (required), can be:\n    \t  • a single token\n    \t  • a list of tokens separated by comma\n    \t  • a file (.tokens) containing 1 token per line\n    \tif the options is not provided, the environment variable GITHUB_TOKEN is readed, it can be:\n    \t  • a single token\n    \t  • a list of tokens separated by comma\n```\n\nIf you want to use multiple tokens, you better create a `.tokens` file in the executable directory with 1 token per line  \n```\ntoken1\ntoken2\n...\n```\nor use an environment variable with tokens separated by comma:  \n```\nexport GITHUB_TOKEN=token1,token2...\n```\n\nTokens are disabled when GitHub raises a rate limit alert, however they are re-enable 1mn later.\nYou can disable that feature by using the option `-k`.\n\n\u003cimg src=\"https://github.com/gwen001/github-subdomains/raw/master/preview.png\"\u003e\n\n## Todo\n\n- change the order of the extra searches ?\n- ?\n\n## Changelog\n\n**20/09/2022**\n- fix regexp for subdomains\n\n**25/09/2020**\n- quick mode added\n- tokens can be read from any file\n\n**23/09/2020**\n- fixed an issue in the api call (params name)\n- added binary\n\n**12/08/2020**\n- improved clean function\n\n**06/08/2020**\n- max_page set forced to 10 to save 1 request for every search\n- new banner (easier to maintain)\n- removed `_` from the regexps\n- extended regexp fixed\n- improved cleaning function\n\n**05/08/2020**\n- added an option to exit the program when all tokens have been disabled instead of waiting\n- rate limited tokens are disabled for 1mn then re-enabled\n- removed options for languages and noise\n- better page management\n- panic errors handled\n\n**04/08/2020**\n- moved default languages and noise to source code\n- added an option for languages and noise\n- bug fixed in searches with language and noise (empty keyword)\n- added search signature to avoid duplicate searches with noise\n- file loading rewritten\n- preview image added\n\n**03/08/2020**\n- fixed delay changed 100 -\u003e 200\n- removed useless debug messages\n\n---\n\nFeel free to [open an issue](/../../issues/) if you have any problem with the script.  \n\n","funding_links":["https://github.com/sponsors/gwen001"],"categories":["Go","Weapons","Go (531)","Recon"],"sub_categories":["Tools","Subdomain Enumeration"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgwen001%2Fgithub-subdomains","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgwen001%2Fgithub-subdomains","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgwen001%2Fgithub-subdomains/lists"}