Censys Python Library

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

Resources

• Official Website
• Documentation
• Issue Tracker

Contributing

All contributions (no matter how small) are always welcome.

Development

$ git clone git@github.com:censys/censys-python.git
$ pip install -e ".[dev]"

Testing

Testing requires credentials to be set.

$ pytest