Skip to content
The official Python library for Shodan
Latest commit 5c85d30 Apr 26, 2016 John Matherly Added the ability to force a scan of an IP


shodan: The official Python library for accessing 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.


  • Search Shodan
  • Streaming API support for real-time consumption of Shodan data
  • Exploit search API fully implemented


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 at

Something went wrong with that request. Please try again.