otty / apps
All apps/Censys CLI

Censys CLI

censys

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

Runs as censys|macOS, Linux, Windows|github.com
Open form in Otty otty.toml

Command form

ai-draft · 3 tasks · 11 fields

Search Censys data, look up a host or certificate, or enumerate subdomains. Credentials (censys config), ASM seed management and account commands are left out.

Opens the form; the finished command lands at your prompt, unrun
Run in Otty
otty gui censys

censys search

Search

Run a Censys search query against hosts or certificates.

SearchExample values, fixed in this page — nothing here reaches a terminal
Basic
Query*
string
Index
2 choicesenum
Pages
integer
Fields
string
TasksEach one presets the form for one job
Search
queryindex_typepagesfields
ParametersOnly these flags are editable in the form
Query
string · positional 0
Index
enum
--index-typehostscertificates
Pages
-1 fetches all pages.
integer
--pages
Fields
Fields to return (certificates index).
string
--fields

censys view

View

View one host (IP) or certificate (fingerprint).

ViewExample values, fixed in this page — nothing here reaches a terminal
Basic
IP or certificate fingerprint*
string
Index
2 choicesenum
Output file
file
At time
string
TasksEach one presets the form for one job
View
assetindex_typeoutputat_time
ParametersOnly these flags are editable in the form
IP or certificate fingerprint
string · positional 0
Index
enum
--index-typehostscertificates
Output file
path
-o
At time
Historical view, hosts index only (YYYY-MM-DD).
string
--at-time

censys subdomains

Subdomains

Enumerate subdomains of a domain.

SubdomainsExample values, fixed in this page — nothing here reaches a terminal
Basic
Domain*
string
Max records
integer
JSON output
--json
TasksEach one presets the form for one job
Enumerate subdomains
domainmax_recordsjson
ParametersOnly these flags are editable in the form
Domain
string · positional 0
Max records
integer
--max-records
JSON output
boolean
--json
SourcesEvery flag above is checked against these
docs
censys search 'ip: 8.8.8.0/16' --pages -1 censys search 'parsed.subject_dn: "censys.io"' --index-type certificates censys search 'parsed.subject.country: AU' --index-type certificates --fields parsed.issuer.organization censys view 8.8.8.8 -o google.json censys view 1.1.1.1 --at-time 2023-01-01 censys subdomains censys.io --max-records 10 censys subdomains c…
manualstable 2026-10-27

censys-python.readthedocs.io

docs
censys search 'ip: 8.8.8.0/16' --pages -1 censys search 'parsed.subject_dn: "censys.io"' --index-type certificates censys search 'parsed.subject.country: AU' --index-type certificates --fields parsed.issuer.organization
manualstable 2026-10-27

censys-python.readthedocs.io

docs
censys view 9b267decc8d23586dc4c56dd0789574cab0f28581ef354ff2fcec8ca6d992fc2 --index-type certificates censys view 8.8.8.8 -o google.json censys view 1.1.1.1 --at-time 2023-01-01
manualstable 2026-10-27

censys-python.readthedocs.io

docs
censys subdomains censys.io --max-records 10 censys subdomains censys.io --json
manualstable 2026-10-27

censys-python.readthedocs.io

Before it fills your prompt, Otty checks the installed censys against its version. A form that does not match your version is not offered.