{"uid":"cap_NEt5pksTo7LTL_1Yrwl1w","slug":"tcp-port-scanner-by-done-4dc0e101","name":"TCP Port Scanner by _done","description":"Give this API a hostname or IP address and it tries connecting to each port in your requested range. For every port that answers it reports whether it is open or blocked, which service is likely running there (a web server, SSH), and what software version was detected. Saves you installing network tools, parsing command-line output, or writing socket loops. Only scan hosts you own or have permission to scan - this tool does not check that for you.","url":"https://port-scanner.underscoredone.com/scan?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"ports":{"type":"string","description":"Which ports to check. Use a range like '1-1000', a comma-separated list like '22,80,443', or leave this out to automatically check the 1000 most commonly used ports."},"target":{"type":"string","description":"The hostname (like 'example.com') or numeric IP address (like '93.184.216.34') you want to scan. Must be a real, reachable address."},"timeout":{"type":"integer","description":"How many seconds the scan is allowed to run before giving up. Must be between 5 and 60. Defaults to 30 if left out."},"scan_type":{"type":"string","description":"How to probe each port. The only supported value right now is 'tcp_connect', which tries to open a full connection - the same way a browser or app would. Defaults to 'tcp_connect' if left out."}}},"responseSchema":{"type":"json","example":{"target":"scanme.nmap.org","warning":"","complete":true,"scan_type":"tcp_connect","open_ports":[{"port":22,"state":"open","service":"ssh","version":"OpenSSH 8.2p1","protocol":"tcp"},{"port":80,"state":"open","service":"http","version":"Apache httpd 2.4.41","protocol":"tcp"}],"api_version":"1.0.0","duration_ms":4521,"resolved_ip":"45.33.32.156","ports_scanned":1000,"ports_requested":1000,"closed_or_filtered_count":998}},"example":{"request":{"ports":"80,443","target":"example.com","timeout":10,"scan_type":"tcp_connect"},"response":{"target":"example.com","warning":null,"complete":true,"scan_type":"tcp_connect","open_ports":[{"port":80,"state":"open","service":"http","version":null,"protocol":"tcp"},{"port":443,"state":"open","service":"https","version":null,"protocol":"tcp"}],"api_version":"1.0.0","duration_ms":10,"resolved_ip":"104.20.23.154","ports_scanned":2,"ports_requested":2,"closed_or_filtered_count":0}},"exampleRequest":{"ports":"80,443","target":"example.com","timeout":10,"scan_type":"tcp_connect"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cZIcpVdj0-cGBKuoP7yel","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scans a hostname or IP address to identify open TCP ports, running services, and software versions across a specified port range","exampleAgentPrompt":"Can you scan my server at 192.168.1.100 and check ports 1 through 1000 to tell me which ones are open, what services are running, and what software versions you detect — give it up to 30 seconds to complete?","exampleUseCases":null,"resultDescription":"Returns a JSON object listing every open port found, including port number, state (open), protocol (tcp), likely service name (e.g. ssh, http), and detected software version (e.g. OpenSSH 8.2p1). Also includes metadata: resolved IP address, total ports scanned, closed/filtered count, scan duration in milliseconds, scan type, and a completion flag.","failureModes":["Target host unreachable or invalid — scan may complete with zero open ports or return an error","Timeout exceeded if host is slow to respond and timeout value is too low","Invalid port range or malformed port specification causes request rejection","Permission denied or blocked by the scanned host's firewall returns ports as closed/filtered rather than open","Scan of non-owned hosts may violate terms of service; API does not enforce authorization"],"whenToPreferThis":"Use this endpoint when you need to programmatically discover open TCP ports and running services on a host without installing nmap or other local network tools. Prefer it over raw socket code when you want structured JSON output including service names and version strings. Best for infrastructure audits, firewall verification, and service discovery on hosts you own or have permission to scan.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:38:30.462Z","isFirstParty":false,"canonicalSlug":"tcp-port-scanner-by-done-4dc0e101"}