The official Python library for Shodan
Switch branches/tags
Nothing to show
Latest commit d8709d0 Aug 22, 2017 @achillean committed on GitHub Merge pull request #49 from francozappa/fix-facets
Facet default is 5 items and not 10. The Shodan CLI requests 10 but the default returned by the API is 5.


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