{"id":13541800,"url":"https://github.com/0xbharath/censys-enumeration","last_synced_at":"2026-01-04T00:54:26.362Z","repository":{"id":29230270,"uuid":"120485364","full_name":"0xbharath/censys-enumeration","owner":"0xbharath","description":"A script to extract subdomains/emails for a given domain using SSL/TLS certificate dataset on Censys","archived":false,"fork":false,"pushed_at":"2022-12-07T23:44:52.000Z","size":1604,"stargazers_count":151,"open_issues_count":5,"forks_count":34,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-11-03T07:32:44.365Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0xbharath.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-02-06T16:11:20.000Z","updated_at":"2024-10-11T00:10:18.000Z","dependencies_parsed_at":"2023-01-14T14:24:39.338Z","dependency_job_id":null,"html_url":"https://github.com/0xbharath/censys-enumeration","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xbharath%2Fcensys-enumeration","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xbharath%2Fcensys-enumeration/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xbharath%2Fcensys-enumeration/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xbharath%2Fcensys-enumeration/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0xbharath","download_url":"https://codeload.github.com/0xbharath/censys-enumeration/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246788770,"owners_count":20834155,"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":[],"created_at":"2024-08-01T10:00:57.226Z","updated_at":"2026-01-04T00:54:26.356Z","avatar_url":"https://github.com/0xbharath.png","language":"Python","funding_links":[],"categories":["Recon","Subdomain Search Tools"],"sub_categories":["Subdomain Enumeration"],"readme":"# Censys Enumeration\n\n- A script to extract subdomains/emails for a given domain using SSL/TLS certificates dataset on Censys\n- The output is in JSON format\n\n## Demo\n\n![script-in-action](imgs/demo.gif)\n## Screenshots\n\n#### Non verbose mode\n![non-verbose](imgs/non_verbose.png)\n\n\n#### Verbose mode\n![verbose](imgs/verbose_output.png)\n\n#### Sample JSON output\n![non-verbose](imgs/sample_json_output.png)\n## 3rd party package dependency \n\n[**censys**](https://pypi.python.org/pypi/censys)\n\n[**click**](https://pypi.python.org/pypi/click)\n\n## Setup\n\n- Clone this repo\n\n```bash\n$ git clone git@github.com:yamakira/censys-enumeration.git\n```\n\n- Install dependencies\n\n```bash\n$ pip install -r requirements.txt\n```\n\n- Get Censys API ID and Censys API secret by creating a account on `https://censys.io`\n\n- Add Censys API ID and Censys API secret as  `CENSYS_API_ID` \u0026 `CENSYS_API_SECRET` respectively to the OS environment variables. On Linux you can use a command similar to following to do this\n\n```bash\n$ export CENSYS_API_SECRET=\"iySd1n0l2JLnHTMisbFHzxClFuE0\"\n```\n\n- Check help menu\n\n\n```bash\n$ python censys_enumeration.py --help                                                                                                 \nUsage: censys_enumeration.py [OPTIONS] FILE\n\nOptions:\n  --verbose                       Verbose output\n  --subdomains / --no-subdomains  Enable/Disable subdomain enumeration\n  --emails / --no-emails          Enable/Disable email enumeration\n  --help                          Show this message and exit.\n```\n\n## Usage\n\n- Subdomain and email enumeration\n\n```\n$ python censys_enumeration.py domains.txt\n```\n\n- Only subdomain enumeration\n\n```\n$ python censys_enumeration.py --no-emails domains.txt \n```\n\n- Only email enumeration\n\n```\n$ python censys_enumeration.py --no-sudomains domains.txt \n```\n\n- Verbose output\n\n```\n$ python censys_enumeration.py --verbose domains.txt \n```\n\n- Output to custom file\n\n$ python censys_enumeration.py --verbose --outfile results.json domains.txt \n```\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xbharath%2Fcensys-enumeration","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0xbharath%2Fcensys-enumeration","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xbharath%2Fcensys-enumeration/lists"}