Skip to main content

An easy-to-use and lightweight API wrapper for Censys APIs (

Project description

Censys Python Library

PyPI Python Version Read the Docs (version) GitHub Discussions PRs Welcome License

An easy-to-use and lightweight API wrapper for Censys APIs ( Python 3.6+ is currently supported.


Getting Started

The library can be installed using pip.

pip install censys

To upgraded using pip.

pip install --upgrade censys

To configure your search 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

To configure your ASM credentials run censys asm config or set the CENSYS_ASM_API_KEY environment variables.

$ censys asm config

Censys ASM API Key: XXX

Successfully authenticated

API Reference and User Guide available on Read the Docs

Read the Docs



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


This project uses poetry for dependency management. Please ensure you have installed the latest version.

git clone
cd censys-python/
poetry install


# With coverage report
pytest --cov-report html


This software is licensed under Apache License, Version 2.0

  • Copyright (C) 2021 Censys, Inc.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for censys, version 2.0.7
Filename, size File type Python version Upload date Hashes
Filename, size censys-2.0.7-py3-none-any.whl (50.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size censys-2.0.7.tar.gz (32.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page