{"api":"subdomain-vulnerability-ranker","status":"healthy","version":"1.0.0","docs":{"endpoints":[{"method":"GET","path":"/preview?domain=example.com","description":"Free preview: Enumerate subdomains and basic exposure check.","parameters":[{"name":"domain","in":"query","required":true,"description":"Target root domain (e.g. example.com)"}],"example_response":{"status":"ok","data":{"domain":"example.com","total_subdomains":3,"subdomains":[{"subdomain":"www.example.com","exposed":true},{"subdomain":"dev.example.com","exposed":false},{"subdomain":"mail.example.com","exposed":true}],"note":"Preview only checks exposure without full scoring.","explanation":"Found 3 subdomains using public certificate transparency and DNS enumeration. Exposure checked via HTTP/HTTPS probe.","checkedAt":"..."},"meta":{"timestamp":"...","duration_ms":114,"api_version":"1.0.0"}}},{"method":"GET","path":"/scan?domain=example.com","description":"Paid: Exhaustive subdomain enumeration, vulnerability inference, scoring, and recommendations.","parameters":[{"name":"domain","in":"query","required":true,"description":"Target root domain (e.g. example.com)"}],"example_response":{"status":"ok","data":{"domain":"example.com","subdomain_count":9,"findings":[{"subdomain":"dev.example.com","issues":[{"issue":"Outdated Server","severity":"high","suggestion":"Upgrade exposed development server running Apache 2.2."},{"issue":"Exposed admin endpoint","severity":"medium","suggestion":"Restrict access or require authentication on /admin."}],"score":45,"grade":"D","notable_endpoints":["/admin","/.env"]}],"overall_score":76,"overall_grade":"B","explanation":"9 subdomains found (via DNS + CT logs). 2 subdomains scored below 50. Outdated and exposed hosts detected.","recommendations":[{"issue":"Development server exposed","severity":"high","suggestion":"Remove dev.example.com from public DNS, restrict by firewall."},{"issue":"Sensitive files discoverable","severity":"medium","suggestion":"Deny access to /.env and /.git via web server rules."}],"checkedAt":"..."},"meta":{"timestamp":"...","duration_ms":611,"api_version":"1.0.0"}}}],"parameters":[{"name":"domain","description":"Target domain, e.g. example.com","type":"string","required":true}],"examples":[{"desc":"Free preview","curl":"curl 'https://subdomain-vulnerability-ranker.apimesh.xyz/preview?domain=example.com'"},{"desc":"Comprehensive scan (paid)","curl":"curl -H 'X-PAYMENT: ...' 'https://subdomain-vulnerability-ranker.apimesh.xyz/scan?domain=example.com'"}]},"pricing":{"/scan (comprehensive audit)":"$0.01"}}