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

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.28

• Add the ability to whitelist a specific vulnerability in Shodan Monitor instead of whitelisting the while IP:port
• Show scan ID when scanning without showing results (credit to @seadog007)
• Handle bad gateway errors (credit to @yaron-cider)

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

Copyright (c) 2014- John Matherly <jmath@shodan.io>