shodan-python v1.26.1 releases: official Python library for Shodan

by do son · Published July 20, 2019 · Updated January 19, 2022

Shodan is a search engine for Internet-connected devices. Google lets you search for websites, Shodan lets you search for devices. This library provides developers easy access to all of the data stored in Shodan in order to automate tasks and integrate into existing tools.

Features

Search Shodan
Fast/ bulk IP lookups
Streaming API support for real-time consumption of Shodan firehose
Network alerts (aka private firehose)
Manage Email Notifications
Exploit search API fully implemented
Bulk data downloads
Command-line interface

Changelog v1.26.1

Fix a Unicode issue that caused the streams to get truncated and error out due to invalid JSON

Installation

$ pip install shodan

Use

from shodan import Shodan

api = Shodan('MY API KEY')

# Lookup an IP
ipinfo = api.host('8.8.8.8')
print(ipinfo)

# Search for websites that have been "hacked"
for banner in api.search_cursor('http.title:"hacked by"'):
    print(banner)

# Get the total number of industrial control systems services on the Internet
ics_services = api.count('tag:ics')
print('Industrial Control Systems: {}'.format(ics_services['total']))

Grab your API key from https://account.shodan.io

Tutorial