Censys-Python : An Easy-To-Use & Lightweight API Wrapper For The Censys Search Engine

Censys-Python is an easy-to-use and lightweight API wrapper for the Censys Search Engine ( Python 3.6+ is currently supported.

Getting Started

The library can be installed using pip.

$ pip install censys

To configure your credentials run censys config or set both CENSYS_API_ID and CENSYS_API_SECRET environment variables.

$ censys config

Censys API ID: XXX
Censys API Secret: XXX

Successfully authenticated for


$ git clone
$ pip install -e “.[dev]”


Testing requires credentials to be set.

$ pytest