Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

Command-line tool for Censys! Quickly investigate suspicious hosts or answer complex questions about your infrastructure using Censys right from the command-line!

Project description

Censys Command Line Tool Examples

This script allows a user to query the Censys API from the command. The results from the query can be written to CSV, JSON, or simply to the screen.

pip install censys-command-line


pip install git+
usage: censys [-h] [--fields FIELDS [FIELDS ...]] --query_type
                              ipv4|certs|websites [--append {true,false}]
                              [--output json|csv|screen]
                              [--start_page START_PAGE]
                              [--max_pages MAX_PAGES]
                              [--censys_api_id XXXXXXXXXX]
                              [--censys_api_secret XXXXXXXXXX]

Search The Censys Data Set via the command line

positional arguments:

optional arguments:
  -h, --help            show this help message and exit
  --fields FIELDS [FIELDS ...]
  --query_type ipv4|certs|websites
  --append {true,false}
                        Append the given list of fields to the default fields
  --output json|csv|screen
  --start_page START_PAGE
  --max_pages MAX_PAGES
  --censys_api_id XXXXXXXXXX
                        (optional) You must provide your Censys API ID here or
                        as an environmental variable CENSYS_API_ID
  --censys_api_secret XXXXXXXXXX
                        (optional) You must provide your Censys API SECRET
                        here or as an environmental variable CENSYS_API_SECRET
Searching IPv4:
censys "ip: [ TO ]" --query_type ipv4 --fields ip protocols --output json
Searching Certificates
censys "parsed.issuer.organization: Let's Encrypt" --query_type=certs

Project details

Download files

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

Files for censys-command-line, version 1.0.4
Filename, size File type Python version Upload date Hashes
Filename, size censys_command_line-1.0.4-py2.py3-none-any.whl (12.6 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size censys_command_line-1.0.4.tar.gz (4.9 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