import censys.certificates

c = censys.certificates.CensysCertificates(api_id="XXX", api_secret="XXX")

# view specific certificate
print c.view("a762bf68f167f6fbdf2ab00fdefeb8b96f91335ad6b483b482dfd42c179be076")

# iterate over certificates that match a search
fields = ["parsed.subject_dn", "parsed.fingerprint_sha256"]
for cert in c.search("github.com and valid_nss: true", fields=fields):
	print cert["parsed.subject_dn"]

# aggregate report on key types used by trusted certificates
print c.report(query="valid_nss: true", field="parsed.subject_key_info.key_algorithm.name")

import censys.ipv4
c = censys.ipv4.CensysIPv4(api_id="XXX", api_secret="XXX")

# the report method constructs a report using a query, an aggretaion field, and the 
# number of buckets to bin
c.report(""" "welcome to" AND tags.raw: "http" """, field="80.http.get.headers.server.raw", buckets=5)

# the view method lets you see the full JSON for an IP address
c.view('8.8.8.8')

# the search method lets you search the index using indexed fields, full text, and 
# combined predicates
for result in c.search("80.http.get.headers.server: Apache AND location.country: Japan", max_records=10):
    print result

# you can optionally specify which fields you want to come back for search results
IPV4_FIELDS = ['ip',
		 'updated_at',
		 '80.http.get.title',
		 '443.https.get.title',
		 '443.https.tls.certificate.parsed.subject_dn',
		 '443.https.tls.certificate.parsed.names',
		 '443.https.tls.certificate.parsed.subject.common_name',
		 '443.https.tls.certificate.parsed.extensions.subject_alt_name.dns_names',
		 '25.smtp.starttls.tls.certificate.parsed.names',
		 '25.smtp.starttls.tls.certificate.parsed.subject_dn',
		 '110.pop3.starttls.tls.certificate.parsed.names',
		 '110.pop3.starttls.tls.certificate.parsed.subject_dn']

data = list(c.search("80.http.get.headers.server: Apache AND location.country: Japan", 
                             IPV4_FIELDS, max_records=10))		 
print data

import censys.data

c = censys.data.CensysData(api_id="XXX", api_secret="XXX")

series_name = '22-ssh-banner-full_ipv4'

# Get a Series
ssh_series = c.view_series(series_name)

# View metadata for all the files in each scan
for scan in ssh_series['results']['historical']:
    print c.view_result(series_name, scan['id'])