Censys-Python is an easy-to-use and lightweight API wrapper for the Censys Search Engine (censys.io). 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 your@email.com
Development
$ git clone git@github.com:censys/censys-python.git
$ pip install -e “.[dev]”
Testing
Testing requires credentials to be set.
$ pytest
Journalists use OSINT to verify public information before publishing. In 2026, misinformation, AI-generated images, fake…
Docker is an open-source platform that lets you package and run applications inside containers. Each container…
PostgreSQL (often called Postgres) is an open-source relational database system. It supports advanced features like JSON…
Xrdp is an open-source server that lets you connect to your Ubuntu machine from another computer…
Apache Tomcat is an open-source web server and Java servlet container. It is one of the…
Keeping your Ubuntu system updated is one of the best ways to protect it. Security…