Shodan
SecuritySearch engine for Internet connected devices. Use the API to automatically generate reports, notify you if something popped up on Shodan or keep track of results over time. The Streaming API gives you the ability to subscribe to events in real-time so you can immediately respond to new discoveries.
📚 Documentation & Examples
Everything you need to integrate with Shodan
🚀 Quick Start Examples
// Shodan API Example
const response = await fetch('https://developer.shodan.io/', {
method: 'GET',
headers: {
'Content-Type': 'application/json'
}
});
const data = await response.json();
console.log(data);An Introduction to the Shodan API
Are you looking for a way to integrate real-time internet scanning and data analytics into your application or website? Look no further than the Shodan API, a powerful tool for transforming raw, unstructured data into useful information.
What is Shodan?
Shodan is a search engine that scans the internet looking for connected devices. Unlike traditional search engines, which look for textual content, Shodan searches for open ports and services on all the devices that have such protocol open. The result is a comprehensive database containing information on almost anything with an internet connection, including servers, cameras, routers, and more.
How to Get a Shodan API Key
- Create an account at account.shodan.io/register and verify your email.
- Your API key is shown at the top of your account overview page.
Important: a free account gives you an API key but no query credits, so most automated API calls (search, host lookups) return errors. To use the API in practice you need a Membership — a one-time $49 purchase that unlocks the API with 100 query credits and 100 scan credits per month. Higher volumes use metered credits or Enterprise plans.
Authenticate by adding your key as the key query parameter:
https://api.shodan.io/shodan/host/8.8.8.8?key=YOUR_API_KEY
The official shodan Python and Node libraries wrap these endpoints, but each ultimately sends your key on the request.
Conclusion
Although the above examples are just a small subset of the Shodan API's capabilities, they should give you a good starting point for integrating Shodan data into your own applications. Whether you're building a security tool or a data analytics platform, the Shodan API can provide powerful insights and real-time internet scanning to drive your analysis.
