shodan: The official Python library and CLI 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
Streaming API support for real-time consumption of Shodan firehose
Exploit search API fully implemented
Bulk data downloads
Access the Shodan DNS DB to view domain information
Quick Start
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
Installation
To install the Shodan library, simply:
$ pip install shodanOr if you don’t have pip installed (which you should seriously install):
$ easy_install shodanDocumentation
Documentation is available at https://shodan.readthedocs.org/ and https://help.shodan.io
1 maintainer
Metadata
1 maintainer
Release files for shodan 1.31.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| shodan-1.31.0.tar.gz | 57.9 kB | Without provenance | Details |
Release files / shodan-1.31.0.tar.gz
| Download URL | shodan-1.31.0.tar.gz |
|---|---|
| Size | 57.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c73275386ea02390e196c35c660706a28dd4d537c5a21eb387ab6236fac251f6
|
|
BLAKE2b-256 checksum How to use checksums |
c506c6dcc975a1e7d89bc764fd271da8138b318e18080b48e7f1acd2ab63df28
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.10.12
|
Security for shodan 1.31.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
