Most businesses do not have a complete picture of what they have connected to the internet: an old server, a security camera, a router someone set up years ago, a database left open by mistake. Attackers go looking for exactly those things. Shodan lets you see what they would see, and it does it through an API, an application programming interface, so your own software (or an AI assistant) can check your exposure on a schedule instead of you remembering to. Here is the Shodan profile on APIs.io.
What Shodan does
Shodan calls itself the world’s first search engine for internet-connected devices. It continuously crawls the public internet to build a searchable database of servers, IoT devices, industrial control systems, routers, webcams, databases and any other host that exposes a service. Alongside REST, Streaming and Trends APIs, it offers on-demand scanning, network alerts, DNS lookups, the InternetDB API and the CVEDB vulnerability database. We index 5 Shodan APIs, including the CVE API.
What you can get done
Find and fix vulnerabilities
A vulnerability is a known weakness in a piece of software, and each one gets an ID called a CVE. Shodan connects the two halves of the job: what is exposed on your network, and which known weaknesses affect it.
GET /cvessearches the vulnerability database.GET /cve/{cveId}gets the full details of one vulnerability.POST /shodan/scanasks Shodan to scan your own addresses right now.GET /shodan/scan/{id}checks on a scan’s progress.GET /shodan/portslists the ports, the numbered doors a service listens on, that Shodan crawls.
Workflows that put it together
A workflow is a recipe: several API calls in a set order that finish one job. We have mapped 15 for Shodan, and these are the ones I would start with:
- Domain Reconnaissance lists a domain’s DNS records, resolves a subdomain, and inspects the host behind it.
- InternetDB Vulnerability Triage pulls the free InternetDB record for an IP address, then details one of its known vulnerabilities.
- CVEDB Product Vulnerability Enrichment turns a product name into its vulnerability list and full details.
- Network Alert Lifecycle creates an alert on your address ranges, turns on a trigger, and keeps the list of addresses up to date.
- Alert With Notifier sets up where alerts get delivered and attaches it to an alert.
- Account Overview shows your plan’s limits and your own IP address.
Getting started
Shodan is freemium with self-serve signup. Plans are in the Pricing section of the APIs.io profile, where a Membership is listed at $49 (one-time). Every request uses an API key, described in Shodan’s API requirements. The docs are the REST API, the Streaming API and the Trends API. On APIs.io, see the Shodan profile, the Account API and the Directory API.
Only scan addresses you own or are authorized to test, and start by looking up your own office IP.
