shodan-python v1.11.1 release: 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

Changelog

v1.11.1

  • Allow a single network alert to monitor multiple IP ranges (#93)

v1.11.0

  • New command shodan scan list to list recently launched scans
  • New command shodan alert triggers to list the available notification triggers
  • New command shodan alert enable to enable a notification trigger
  • New command shodan alert disable to disable a notification trigger
  • New command shodan alert info to show details of a specific alert
  • Include timestamp, vulns and tags in CSV converter (#85)
  • Fixed bug that caused an exception when parsing uncompressed data files in Python3
  • Code quality improvements
  • Thank you for contributions from @wagner-certat@cclauss@opt9@voldmar and Antoine Neuenschwander

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>

Share