Quick Start

Assuming you have Python already, install the package:

pip install censys

If you do not have pip installed, get it here.

Configure your credentials:

censys config

Or you can set the environment variables:

export CENSYS_API_ID=<your-api-id>
export CENSYS_API_SECRET=<your-api-secret>

Find your credentials on the Account page.

Optionally, you can enable tab completion for the CLI by adding this line to your ~/.bashrc, ~/.zshrc, or equivalent.

eval "$(register-python-argcomplete censys)"


Please note that autocomplete is supported for field names in the search command.