{"id":23835169,"url":"https://github.com/opcod3r/godan","last_synced_at":"2025-06-18T18:07:15.154Z","repository":{"id":251655100,"uuid":"838043529","full_name":"opcod3r/godan","owner":"opcod3r","description":"Shodan tool subdomains with rotation keys.. 🎩","archived":false,"fork":false,"pushed_at":"2024-09-16T22:28:57.000Z","size":81,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-08T03:01:49.619Z","etag":null,"topics":["bugbounty","bugbounty-tool","golang","pentest","recon","security","shodan","subdomains"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/opcod3r.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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-08-04T19:16:26.000Z","updated_at":"2025-02-02T08:27:54.000Z","dependencies_parsed_at":"2025-01-02T15:39:41.606Z","dependency_job_id":null,"html_url":"https://github.com/opcod3r/godan","commit_stats":null,"previous_names":["opcod3r/godan"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/opcod3r/godan","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opcod3r%2Fgodan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opcod3r%2Fgodan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opcod3r%2Fgodan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opcod3r%2Fgodan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/opcod3r","download_url":"https://codeload.github.com/opcod3r/godan/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opcod3r%2Fgodan/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260606474,"owners_count":23035350,"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","bugbounty-tool","golang","pentest","recon","security","shodan","subdomains"],"created_at":"2025-01-02T15:27:19.202Z","updated_at":"2025-06-18T18:07:10.140Z","avatar_url":"https://github.com/opcod3r.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"### Godan ( Golang + Shodan ) \n\nThis is a command-line tool that finds subdomains for a given domain using the Shodan API. It supports multiple API keys and handles rate limiting by pausing between requests. The tool also provides detailed output and logging options.\n\n## Features\n\n- Finds subdomains for a given domain using Shodan API\n- Supports multiple Shodan API keys\n- Handles rate limiting by pausing between requests\n- Saves found subdomains to a file\n- Provides detailed output and logging with a verbose option\n- Loads domains from an input file\n- Displays API usage information\n\n## Installation\n\nTo use this tool, you need to have [Go](https://golang.org/) installed. Clone the repository and build the project:\n\n```sh\ngit clone https://github.com/opcod3r/godan.git\ncd godan\ngo mod init github.com/opcod3r/godan\ngo build -o godan\n```\n\n## Usage\n\n```sh\n./godan -d \u003cdomain\u003e [-f \u003cinput_file\u003e] [-k \u003ckeys_file\u003e] [-o \u003coutput_file\u003e] [-v]\n```\n\n### Options\n\n- `-d \u003cdomain\u003e`: The target domain to find subdomains for.\n- `-f \u003cinput_file\u003e`: A file containing a list of domains to find subdomains for (one per line).\n- `-k \u003ckeys_file\u003e`: A file containing Shodan API keys (one per line). Defaults to `keys.txt`.\n- `-o \u003coutput_file\u003e`: Save the found subdomains to a file.\n- `-v`: Enable verbose output for detailed logging.\n\n### Examples\n\n#### Finding Subdomains for a Single Domain\n\n```sh\n./godan -d example.com -k keys.txt\n```\n\n#### Finding Subdomains for Multiple Domains from a File\n\n```sh\n./godan -f domains.txt -k keys.txt\n```\n\n#### Saving Subdomains to a File\n\n```sh\n./godan -d example.com -k keys.txt -o subdomains.txt\n```\n\n#### Enabling Verbose Output\n\n```sh\n./godan -d example.com -k keys.txt -v\n```\n\n## Detailed Example\n\nHere is a detailed example of how to use this tool with all the features enabled:\n\n1. Create a file named `keys.txt` and add your Shodan API keys (one per line):\n\n    ```\n    key1\n    key2\n    key3\n    ```\n\n2. Create a file named `domains.txt` and add the domains you want to search for (one per line):\n\n    ```\n    example.com\n    anotherdomain.com\n    ```\n\n3. Run the tool:\n\n    ```sh\n    ./godan -f domains.txt -k keys.txt -o subdomains.txt -v\n    ```\n\n    This command will:\n    - Read the domains from `domains.txt`\n    - Use the API keys from `keys.txt`\n    - Save the found subdomains to `subdomains.txt`\n    - Enable verbose output for detailed logging\n\n![](image.png)\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopcod3r%2Fgodan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopcod3r%2Fgodan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopcod3r%2Fgodan/lists"}