{"id":29458147,"url":"https://github.com/melbadry9/scanapi","last_synced_at":"2025-07-13T23:10:04.798Z","repository":{"id":50440518,"uuid":"184845187","full_name":"melbadry9/ScanApi","owner":"melbadry9","description":"Subdomains-enumeration, subdomain-takeover monitoring api and S3 bucket scanner.","archived":false,"fork":false,"pushed_at":"2023-05-01T14:47:20.000Z","size":47539,"stargazers_count":38,"open_issues_count":0,"forks_count":19,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-07-11T17:50:46.415Z","etag":null,"topics":["bugbounty","recon","s3-bucket-scanner","subdomains-enumeration"],"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/melbadry9.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"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},"funding":{"custom":["paypal.me/elbadry9","buymeacoffee.com/melbadry9"]}},"created_at":"2019-05-04T02:52:04.000Z","updated_at":"2024-09-10T07:25:10.000Z","dependencies_parsed_at":"2024-11-21T14:42:52.156Z","dependency_job_id":null,"html_url":"https://github.com/melbadry9/ScanApi","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/melbadry9/ScanApi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melbadry9%2FScanApi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melbadry9%2FScanApi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melbadry9%2FScanApi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melbadry9%2FScanApi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/melbadry9","download_url":"https://codeload.github.com/melbadry9/ScanApi/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melbadry9%2FScanApi/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265218750,"owners_count":23729528,"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","recon","s3-bucket-scanner","subdomains-enumeration"],"created_at":"2025-07-13T23:10:04.065Z","updated_at":"2025-07-13T23:10:04.768Z","avatar_url":"https://github.com/melbadry9.png","language":"Python","funding_links":["paypal.me/elbadry9","buymeacoffee.com/melbadry9","https://buymeacoffee.com/melbadry9"],"categories":[],"sub_categories":[],"readme":"# ScanApi ![Python 3.5](https://img.shields.io/badge/Python-3.x-blue.svg) ![linux 64-bit](https://img.shields.io/badge/Linux-64bit-blue.svg) [![Total alerts](https://img.shields.io/lgtm/alerts/g/melbadry9/ScanApi.svg?logo=lgtm\u0026logoWidth=18)](https://lgtm.com/projects/g/melbadry9/ScanApi/alerts/) [![Language grade: Python](https://img.shields.io/lgtm/grade/python/g/melbadry9/ScanApi.svg?logo=lgtm\u0026logoWidth=18)](https://lgtm.com/projects/g/melbadry9/ScanApi/context:python)\r\n\r\nSubdomains-enumeration, subdomain-takeover monitoring api and S3 bucket scanner.\r\n\r\n## Installing\r\n\r\n- Linux\r\n\r\n ```bash\r\ngit clone https://github.com/melbadry9/ScanApi.git\r\ncd ScanApi\r\nsudo bash install.sh\r\npython3 app.py\r\n```\r\n\r\n- Docker\r\n\r\n```bash\r\ndocker build -t scanapi:latest .\r\ndocker run -d -p 8000:8000 scanapi\r\n```\r\n\r\n- Update `config.ini` before building docker image.\r\n\r\n- Add slack hook in `config.ini` if Slack is Enabled.\r\n\r\n- Commit docker image `docker commit \u003ccontainer id\u003e scanapi:latest` to avoid losing data from db.\r\n\r\n## Endpoints  \r\n\r\n1. `/enum/domain/\u003cdomain\u003e/`\r\n    - Start subdomain enumeration task in background then update db\r\n    - Domain ex: `example.com`\r\n\r\n2. `/enum/s3/\u003cbucket-name\u003e/`\r\n    - Start s3 bucket permissions scanner and update db\r\n    - Bucket-name ex: `example-prod`\r\n\r\n3. `/db/domain/\u003cdomain\u003e/`\r\n    - Retrieve all subdomains from db if any exist\r\n\r\n4. `/db/domain/\u003cdomain\u003e/?pro=http`\r\n    - Retrieve subdomains with port 80 opened from db if any exist\r\n\r\n5. `/db/domain/\u003cdomain\u003e/?pro=https`\r\n    - Retrieve subdomains with port 443 opened from db if any exist\r\n\r\n6. `/db/s3/\u003cbucket-name\u003e/`\r\n    - Retrieve s3 bucket scanner data from db if any exist\r\n\r\n7. `/scan/domain/\u003cdomain\u003e/`\r\n    - Start scanning for possible subdomain takeover depending on db\r\n    - Domain ex: `example.com`\r\n\r\n## Supported Tools\r\n\r\n- [Amass](https://github.com/OWASP/Amass)\r\n- [Gasset](https://github.com/melbadry9/gasset)\r\n- [Findomain](https://github.com/Edu4rdSHL/findomain)\r\n- [Subfinder](https://github.com/projectdiscovery/subfinder)\r\n- [Subover](https://github.com/melbadry9/SubOver)\r\n- [Sublist3r](https://github.com/melbadry9/Sublist3r)\r\n- [Httprobe](https://github.com/tomnomnom/httprobe)\r\n- [Gobuster](https://github.com/OJ/gobuster)\r\n- [Assetfinder](https://github.com/tomnomnom/assetfinder)\r\n- [Chaos](https://github.com/projectdiscovery/chaos-client)\r\n\r\n## To-Do list\r\n\r\n- [ ] Add directory brute forcing monitoring\r\n- [ ] Add open ports monitoring\r\n- [ ] Add scheduling jobs\r\n- [ ] Add UI\r\n\r\n## Donation\r\n\r\n[![Coffee](https://www.buymeacoffee.com/assets/img/custom_images/black_img.png)](https://buymeacoffee.com/melbadry9)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmelbadry9%2Fscanapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmelbadry9%2Fscanapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmelbadry9%2Fscanapi/lists"}