Repository files navigation

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 thedata stored in Shodan in order to automate tasks and integrate into existing tools.

• 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
• Access the Shodan DNS DB to view domain information
• Command-line interface

fromshodanimportShodanapi=Shodan('MY API KEY')# Lookup an IPipinfo=api.host('8.8.8.8')print(ipinfo)# Search for websites that have been "hacked"forbannerinapi.search_cursor('http.title:"hacked by"'):print(banner)# Get the total number of industrial control systems services on the Internetics_services=api.count('tag:ics')print('Industrial Control Systems: {}'.format(ics_services['total']))

Grab your API key fromhttps://account.shodan.io

To install the Shodan library, simply:

$ pip install shodan

Or if you don't have pip installed (which you should seriously install):

$ easy_install shodan

Documentation is available athttps://shodan.readthedocs.org/ andhttps://help.shodan.io