Censys

App · 25 actions

Look up and search Censys' internet-wide scan data on hosts, certificates and websites, read their history, manage collections, hunt threats and manage your attack surface's seeds and risks, with triggers for new search results, collection changes and new risks.

Actions

ActionWhat it does
Add attack surface seedsAdd up to 50 seeds to your attack surface: IP addresses, CIDR blocks, ASNs (such as AS15169), domains or certificate fingerprints.
Convert Legacy Search queriesRewrite queries written for Censys Legacy Search in the Platform's CenQL, with notes on anything that didn't carry over.
Count collection by fieldCount a collection's assets matching a CenQL query by one field's values, such as port, country or software.
Count search results by fieldCount a CenQL query's matches by one field's values, such as port, country or ASN, without fetching every record, like Censys' Report Builder.
Create collectionSave a CenQL query as a collection: a group of assets Censys keeps up to date as the internet changes, which the collection triggers can watch.
Delete collectionDelete a collection.
Get certificateLook up a TLS certificate by its SHA-256 fingerprint: who it was issued to and by, the names it covers, when it is valid and whether it was revoked.
Get collectionGet one collection with its query, status and how many assets it holds and gained or lost in the last day.
Get credit balanceGet your organization's Censys credit balance, when its credits expire, and its automatic top up setting.
Get DNS historySee the DNS records a domain resolved to (A, AAAA, MX, NS, SOA, TXT), with when each was first and last seen.
Get hostLook up an IP address: its open services and software, location, network owner, DNS names and labels, now or at a past time.
Get host historySee what changed on an IP address between two times: services opened or closed, certificates swapped, software changed.
Get host threat historySee when threats were detected on an IP address, as time ranges, to tell whether it was malicious during an incident.
Get hosts seen with certificateSee every IP address that presented a certificate, and when, to find other infrastructure using it.
Get web propertyLook up a website by host name and port: its pages, software, certificate, threats and vulnerabilities, now or at a past time.
List active threatsList the threats (malware, C2 frameworks and other malicious infrastructure) Censys currently sees, with how many hosts and websites show each.
List attack surface seedsList the seeds (IPs, CIDR blocks, ASNs, domains and certificates) Censys discovers your attack surface from.
List collection eventsList what happened to a collection: assets added or removed, and status changes, with when and why.
List collectionsList your organization's collections with their queries, status and asset counts.
List risk eventsList risks opened, resolved or reopened on your attack surface, with the risk, its severity and the affected asset.
Remove attack surface seedRemove a seed from your attack surface.
SearchSearch Censys' internet-wide data for hosts, certificates and web properties with a CenQL query, such as a banner, JARM, favicon hash or software.
Search attack surfaceSearch only your attack surface's hosts, web properties and certificates with a CenQL query; a query on risk fields returns risks instead.
Search collectionSearch only a collection's assets with a CenQL query, so results stay inside the scope you monitor.
Update collectionChange a collection's name, query, description or who can see it.

Add attack surface seeds

Add up to 50 seeds to your attack surface: IP addresses, CIDR blocks, ASNs (such as AS15169), domains or certificate fingerprints. Adding one already there is not an error. Free.

Inputs

SeedsseedslistRequired
The seeds to add, such as example.com, 203.0.113.0/24 or AS15169.

Outputs

countnumber
How many
seedslist
The seeds added
Example output
{
  "count": 1,
  "seeds": [
    {
      "asset": "example.com",
      "type": "domain"
    }
  ]
}

Convert Legacy Search queries

Rewrite queries written for Censys Legacy Search in the Platform's CenQL, with notes on anything that didn't carry over.

Inputs

Legacy querieslegacy_querieslistRequired
One or more Legacy Search queries, up to 50.

Outputs

conversionslist
Each query with its CenQL version
countnumber
How many queries
Example output
{
  "conversions": [
    {
      "comments": [],
      "converted_query": "host.services.protocol: SSH",
      "errors": [],
      "original_query": "services.service_name: SSH",
      "targets": [
        "host"
      ]
    }
  ],
  "count": 1
}

Count collection by field

Count a collection's assets matching a CenQL query by one field's values, such as port, country or software.

Inputs

Collectioncollection_idtextRequired
The collection. Pick one, or give its ID from an earlier step.
QueryquerytextRequired
A Censys Query Language (CenQL) query, as typed in the Censys search bar.
Break down byaggregate_fieldtextRequired
The field whose values to count, in dot notation, such as host.services.port or host.location.country.
Number of valuesnumber_of_bucketsnumber
How many of the most common values to return, 1 to 2,000. Defaults to 25.From 1 to 2000.
Only values the query matchesfilter_by_querytrue/false
Count only values that match the query itself. Off counts every value on the matching records, such as every port on a host found for SSH.
Count bycount_by_leveltext
For a nested field, what each count counts: leave empty for the deepest level, '.' for whole records (such as hosts), or a level such as host.services.

Outputs

bucketslist
Each value with how many have it
countnumber
How many values
is_more_than_total_hitstrue/false
True when the counts are estimates
other_countnumber
How many have a value not listed
query_duration_millisnumber
How long it took, in milliseconds
total_countnumber
How many records matched
Example output
{
  "buckets": [
    {
      "count": 40,
      "key": "3389"
    },
    {
      "count": 12,
      "key": "443"
    }
  ],
  "count": 2,
  "is_more_than_total_hits": false,
  "other_count": 0,
  "query_duration_millis": 31,
  "total_count": 42
}

Count search results by field

Count a CenQL query's matches by one field's values, such as port, country or ASN, without fetching every record, like Censys' Report Builder.

Inputs

QueryquerytextRequired
A Censys Query Language (CenQL) query, as typed in the Censys search bar.
Break down byaggregate_fieldtextRequired
The field whose values to count, in dot notation, such as host.services.port or host.location.country.
Number of valuesnumber_of_bucketsnumber
How many of the most common values to return, 1 to 2,000. Defaults to 25.From 1 to 2000.
Only values the query matchesfilter_by_querytrue/false
Count only values that match the query itself. Off counts every value on the matching records, such as every port on a host found for SSH.
Count bycount_by_leveltext
For a nested field, what each count counts: leave empty for the deepest level, '.' for whole records (such as hosts), or a level such as host.services.

Outputs

bucketslist
Each value with how many have it
countnumber
How many values
is_more_than_total_hitstrue/false
True when the counts are estimates
other_countnumber
How many have a value not listed
query_duration_millisnumber
How long it took, in milliseconds
total_countnumber
How many records matched
Example output
{
  "buckets": [
    {
      "count": 120034,
      "key": "22"
    },
    {
      "count": 8123,
      "key": "2222"
    }
  ],
  "count": 2,
  "is_more_than_total_hits": false,
  "other_count": 0,
  "query_duration_millis": 340,
  "total_count": 128157
}

Create collection

Save a CenQL query as a collection: a group of assets Censys keeps up to date as the internet changes, which the collection triggers can watch. Free.

Inputs

NamenametextRequired
The collection's name.
QueryquerytextRequired
A Censys Query Language (CenQL) query, as typed in the Censys search bar.
Descriptiondescriptiontext
What the collection is for.
Who can see itprivacytext
Private to you, or shared with your organization.One of: private (Private: only you (default)), shared (Shared with your organization).

Outputs

collectionobject
The collection
Example output
{
  "collection": {
    "added_assets_24_hours": 3,
    "create_time": "2026-10-01T09:00:00Z",
    "created_by": "6f2a9a8e-1c1d-4f6b-9a2e-3c4d5e6f7a8b",
    "description": "Hosts with RDP open in our ranges",
    "id": "364133a0-53ae-4f51-82d0-17c25aed92e3",
    "name": "Internet-facing RDP",
    "privacy": "private",
    "query": "host.services.protocol=\"RDP\" and host.autonomous_system.asn=20115",
    "removed_assets_24_hours": 1,
    "status": "populating",
    "status_reason": "initial",
    "total_assets": 42
  }
}

Delete collection

Delete a collection. Free.

Inputs

Collectioncollection_idtextRequired
The collection. Pick one, or give its ID from an earlier step.

Outputs

collection_idtext
The collection deleted
deletedtrue/false
Always true once deleted
Example output
{
  "collection_id": "364133a0-53ae-4f51-82d0-17c25aed92e3",
  "deleted": true
}

Get certificate

Look up a TLS certificate by its SHA-256 fingerprint: who it was issued to and by, the names it covers, when it is valid and whether it was revoked. Costs one Censys credit.

Inputs

Certificate SHA-256 fingerprintcertificate_fingerprinttextRequired
The certificate's SHA-256 fingerprint: 64 hexadecimal characters, colons allowed.

Outputs

certificateobject
The certificate
Example output
{
  "certificate": {
    "added_at": "2026-09-01T02:11:09Z",
    "fingerprint_sha1": "8d4c0a8f9b3c1e1d2a6b5c4d3e2f1a0b9c8d7e6f",
    "fingerprint_sha256": "f9f055ac237c123b9a7a8644832319ad41d399c9f714f52bc6a02c4a875cfb27",
    "names": [
      "www.example.com",
      "example.com"
    ],
    "parsed": {
      "issuer_dn": "C=US, O=Let's Encrypt, CN=R11",
      "serial_number": "421389561781245312341234",
      "subject_dn": "CN=www.example.com",
      "validity_period": {
        "not_after": "2026-11-30T00:00:00Z",
        "not_before": "2026-09-01T00:00:00Z"
      }
    },
    "revoked": false,
    "validation_level": "dv"
  }
}

Get collection

Get one collection with its query, status and how many assets it holds and gained or lost in the last day. Free.

Inputs

Collectioncollection_idtextRequired
The collection. Pick one, or give its ID from an earlier step.

Outputs

collectionobject
The collection
Example output
{
  "collection": {
    "added_assets_24_hours": 3,
    "create_time": "2026-10-01T09:00:00Z",
    "created_by": "6f2a9a8e-1c1d-4f6b-9a2e-3c4d5e6f7a8b",
    "description": "Hosts with RDP open in our ranges",
    "id": "364133a0-53ae-4f51-82d0-17c25aed92e3",
    "name": "Internet-facing RDP",
    "privacy": "private",
    "query": "host.services.protocol=\"RDP\" and host.autonomous_system.asn=20115",
    "removed_assets_24_hours": 1,
    "status": "active",
    "status_reason": "initial",
    "total_assets": 42
  }
}

Get credit balance

Get your organization's Censys credit balance, when its credits expire, and its automatic top up setting. Free.

Inputs

None.

Outputs

auto_replenishobject
Whether credits top up by themselves
balancenumber
Credits left
credit_expirationslist
Each batch of credits with when it expires
organization_idtext
The organization
Example output
{
  "auto_replenish": {
    "amount": 0,
    "enabled": false,
    "threshold": 0
  },
  "balance": 48210,
  "credit_expirations": [
    {
      "balance": 48210,
      "created_at": "2026-01-15T00:00:00Z",
      "expires_at": "2027-01-15T00:00:00Z",
      "initial_balance": 50000
    }
  ],
  "organization_id": "1b4e28ba-2fa1-11d2-883f-0016d3cca427"
}

Get DNS history

See the DNS records a domain resolved to (A, AAAA, MX, NS, SOA, TXT), with when each was first and last seen. Gets one page; to see more, run it again with the next page it gives.

Inputs

DomaindomaintextRequired
The domain or host name, such as example.com.
Record typesrecord_typeslist
Only these kinds of record. Leave empty for all.One or more of: A (A (IPv4 address)), AAAA (AAAA (IPv6 address)), MX (MX (mail server)), NS (NS (name server)), SOA (SOA (zone authority)), TXT (TXT (text)).
Fromfrom_timedate and time
Start of the window. Leave empty for as far back as your plan allows.
Untiluntil_timedate and time
End of the window. Leave empty for now.
Page sizepage_sizenumber
How many to return, 1 to 100. Censys' default is 100.From 1 to 100.
Page tokenpage_tokentext
The 'next_page_token' from an earlier run, to get the page after it.

Outputs

countnumber
How many on this page
nametext
The name looked up
next_page_tokentext
Pass as 'Page token' for the next page; empty on the last one
recordslist
The records and when seen
total_recordsnumber
How many records in all
Example output
{
  "count": 1,
  "name": "example.com",
  "next_page_token": "",
  "records": [
    {
      "first_observed": "2026-10-01T00:00:00Z",
      "last_observed": "2026-11-06T00:00:00Z",
      "record_type": "A",
      "value": "93.184.215.14"
    }
  ],
  "total_records": 1
}

Get host

Look up an IP address: its open services and software, location, network owner, DNS names and labels, now or at a past time. Costs one Censys credit.

Inputs

IP addresshost_iptextRequired
The host's IP address, IPv4 or IPv6.
As it was atat_timedate and time
See the record as Censys saw it at this time. Leave empty for now.

Outputs

hostobject
The host
Example output
{
  "host": {
    "autonomous_system": {
      "asn": 20115,
      "bgp_prefix": "47.33.192.0/19",
      "country_code": "US",
      "description": "ACME-20115",
      "name": "ACME-20115"
    },
    "dns": {
      "names": [
        "syn-047-033-210-014.res.acme.com"
      ],
      "reverse_dns": {
        "names": [
          "syn-047-033-210-014.res.acme.com"
        ]
      }
    },
    "ip": "47.33.210.14",
    "labels": [],
    "location": {
      "city": "Mount Pleasant",
      "continent": "North America",
      "coordinates": {
        "latitude": 43.59781,
        "longitude": -84.76751
      },
      "country": "United States",
      "country_code": "US",
      "postal_code": "48858",
      "province": "Michigan",
      "timezone": "America/Detroit"
    },
    "service_count": 1,
    "services": [
      {
        "banner_hash_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
        "port": 7547,
        "protocol": "CWMP",
        "scan_time": "2026-11-06T19:03:55Z",
        "transport_protocol": "tcp"
      }
    ],
    "whois": {
      "network": {
        "handle": "AC04",
        "name": "Acme"
      }
    }
  }
}

Get host history

See what changed on an IP address between two times: services opened or closed, certificates swapped, software changed. How far back you can look depends on your plan.

Inputs

IP addresshost_iptextRequired
The host's IP address, IPv4 or IPv6.
Fromfrom_timedate and timeRequired
Start of the window.
Untiluntil_timedate and time
End of the window. Leave empty for now.

Outputs

countnumber
How many changes
eventslist
Each change Censys saw, newest first
scanned_totext
Censys has scanned the host up to this time
Example output
{
  "count": 1,
  "events": [
    {
      "extensions": {},
      "resource": {
        "event_time": "2026-11-05T10:12:00Z",
        "service_scanned": {
          "scan": {
            "port": 443,
            "protocol": "HTTP"
          }
        }
      }
    }
  ],
  "scanned_to": "2026-11-06T19:03:55Z"
}

Get host threat history

See when threats were detected on an IP address, as time ranges, to tell whether it was malicious during an incident. Needs the Adversary Investigation module.

Inputs

IP addresshost_iptextRequired
The host's IP address, IPv4 or IPv6.
Fromfrom_timedate and time
Start of the window. Leave empty for as far back as your plan allows.
Untiluntil_timedate and time
End of the window. Leave empty for now.
Threatthreat_nametext
Only this threat, by name. Leave empty for all.
Portportnumber
Only this port. Leave empty for all.From 1 to 65535.
Transporttransport_protocoltext
Only TCP or only UDP. Leave empty for both.One of: tcp, udp.
Page sizepage_sizenumber
How many to return, 1 to 100. Censys' default is 100.From 1 to 100.
Page tokenpage_tokentext
The 'next_page_token' from an earlier run, to get the page after it.

Outputs

countnumber
How many on this page
next_page_tokentext
Pass as 'Page token' for the next page; empty on the last one
rangeslist
Each threat with when it was seen
Example output
{
  "count": 1,
  "next_page_token": "",
  "ranges": [
    {
      "end_time": "2026-11-02T00:00:00Z",
      "ip": "47.33.210.14",
      "port": "443",
      "protocol": "HTTP",
      "start_time": "2026-10-28T00:00:00Z",
      "threat_name": "Cobalt Strike",
      "transport_protocol": "tcp"
    }
  ]
}

Get hosts seen with certificate

See every IP address that presented a certificate, and when, to find other infrastructure using it. Needs the Adversary Investigation module.

Inputs

Certificate SHA-256 fingerprintcertificate_fingerprinttextRequired
The certificate's SHA-256 fingerprint: 64 hexadecimal characters, colons allowed.
Fromfrom_timedate and time
Start of the window. Leave empty for as far back as your plan allows.
Untiluntil_timedate and time
End of the window. Leave empty for now.
Portportnumber
Only this port. Leave empty for all.From 1 to 65535.
Page sizepage_sizenumber
How many to return, 1 to 100. Censys' default is 100.From 1 to 100.
Page tokenpage_tokentext
The 'next_page_token' from an earlier run, to get the page after it.

Outputs

countnumber
How many on this page
next_page_tokentext
Pass as 'Page token' for the next page; empty on the last one
rangeslist
Each host with when it presented the certificate
total_resultsnumber
How many in all
Example output
{
  "count": 1,
  "next_page_token": "",
  "ranges": [
    {
      "end_time": "2026-11-06T00:00:00Z",
      "ip": "47.33.210.14",
      "port": 443,
      "protocols": [
        "HTTP"
      ],
      "start_time": "2026-10-01T00:00:00Z",
      "transport_protocol": "tcp"
    }
  ],
  "total_results": 1
}

Get web property

Look up a website by host name and port: its pages, software, certificate, threats and vulnerabilities, now or at a past time. Costs one Censys credit.

Inputs

Host namehostnametextRequired
The website's host name, such as www.example.com.
Portportnumber
The port it answers on. Defaults to 443.From 1 to 65535.
As it was atat_timedate and time
See the record as Censys saw it at this time. Leave empty for now.

Outputs

web_propertyobject
The web property
web_property_idtext
Censys' ID for it, hostname:port
Example output
{
  "web_property": {
    "cert": {
      "fingerprint_sha256": "f9f055ac237c123b9a7a8644832319ad41d399c9f714f52bc6a02c4a875cfb27",
      "names": [
        "www.example.com",
        "example.com"
      ]
    },
    "endpoints": [
      {
        "endpoint_type": "HTTP",
        "path": "/"
      }
    ],
    "hostname": "www.example.com",
    "port": 443,
    "scan_time": "2026-11-06T19:03:55Z",
    "software": [
      {
        "product": "nginx",
        "vendor": "nginx"
      }
    ],
    "threats": [],
    "vulns": []
  },
  "web_property_id": "www.example.com:443"
}

List active threats

List the threats (malware, C2 frameworks and other malicious infrastructure) Censys currently sees, with how many hosts and websites show each. Needs the Adversary Investigation module.

Inputs

Filterquerytext
A CenQL filter to narrow the list. Leave empty for every threat.

Outputs

countnumber
How many threats
threatslist
The threats
Example output
{
  "count": 1,
  "threats": [
    {
      "added_at": "2025-01-10T00:00:00Z",
      "count": 812,
      "description": "A commercial adversary simulation framework.",
      "host_count": 790,
      "id": "cobalt-strike",
      "name": "Cobalt Strike",
      "references": [
        "https://www.cobaltstrike.com/"
      ],
      "web_count": 22
    }
  ]
}

List attack surface seeds

List the seeds (IPs, CIDR blocks, ASNs, domains and certificates) Censys discovers your attack surface from. Needs Attack Surface Management. Free.

Inputs

Page sizepage_sizenumber
How many to return, 1 to 200. Censys' default is 50.From 1 to 200.
Page tokenpage_tokentext
The 'next_page_token' from an earlier run, to get the page after it.

Outputs

countnumber
How many on this page
next_page_tokentext
Pass as 'Page token' for the next page; empty on the last one
seedslist
The seeds
Example output
{
  "count": 2,
  "next_page_token": "",
  "seeds": [
    {
      "asset": "example.com",
      "type": "domain"
    },
    {
      "asset": "203.0.113.0/24",
      "type": "netblock"
    }
  ]
}

List collection events

List what happened to a collection: assets added or removed, and status changes, with when and why. Free. Gets one page; to see more, run it again with the next page it gives.

Inputs

Collectioncollection_idtextRequired
The collection. Pick one, or give its ID from an earlier step.
Kind of eventevent_kindtext
Only asset changes, or only status changes. Leave empty for both.One of: asset (Assets added or removed), status (Status changes).
Asset changeasset_changetext
Only assets added, or only assets removed. Leave empty for both.One of: added, removed.
Fromfrom_timedate and time
Start of the window. Leave empty for as far back as your plan allows.
Untiluntil_timedate and time
End of the window. Leave empty for now.
Page sizepage_sizenumber
How many to return, 1 to 100. Leave empty for Censys' default.From 1 to 100.
Page tokenpage_tokentext
The 'next_page_token' from an earlier run, to get the page after it.

Outputs

countnumber
How many on this page
eventslist
Each event: an asset_change or a status_change
next_page_tokentext
Pass as 'Page token' for the next page; empty on the last one
Example output
{
  "count": 1,
  "events": [
    {
      "asset_change": {
        "change_type": "added",
        "event_time": "2026-11-06T20:03:01Z",
        "reason": "host 47.33.210.14 was added to collection 364133a0-53ae-4f51-82d0-17c25aed92e3 based on the collection query."
      },
      "status_change": {}
    }
  ],
  "next_page_token": ""
}

List collections

List your organization's collections with their queries, status and asset counts. Free. Gets one page; to see more, run it again with the next page it gives.

Inputs

Statusstatuseslist
Only collections in these states. Leave empty for all.One or more of: populating, active, paused, archived.
Page sizepage_sizenumber
How many to return, 1 to 100. Leave empty for Censys' default.From 1 to 100.
Page tokenpage_tokentext
The 'next_page_token' from an earlier run, to get the page after it.

Outputs

collectionslist
The collections
countnumber
How many on this page
next_page_tokentext
Pass as 'Page token' for the next page; empty on the last one
Example output
{
  "collections": [
    {
      "added_assets_24_hours": 3,
      "create_time": "2026-10-01T09:00:00Z",
      "created_by": "6f2a9a8e-1c1d-4f6b-9a2e-3c4d5e6f7a8b",
      "description": "Hosts with RDP open in our ranges",
      "id": "364133a0-53ae-4f51-82d0-17c25aed92e3",
      "name": "Internet-facing RDP",
      "privacy": "private",
      "query": "host.services.protocol=\"RDP\" and host.autonomous_system.asn=20115",
      "removed_assets_24_hours": 1,
      "status": "active",
      "status_reason": "initial",
      "total_assets": 42
    }
  ],
  "count": 1,
  "next_page_token": ""
}

List risk events

List risks opened, resolved or reopened on your attack surface, with the risk, its severity and the affected asset. Needs Attack Surface Management. Free. Gets one page; to see more, run it again with the next page it gives.

Inputs

Changechange_typeslist
Only these changes. Leave empty for all.One or more of: opened, resolved, reopened.
Severityseveritieslist
Only risks of these severities. Leave empty for all.One or more of: CRITICAL, HIGH, MEDIUM, LOW.
Rapid responserapid_responsetext
Only risks Censys flagged for rapid response, or only the rest. Leave empty for both.One of: true (Only rapid response risks), false (Only other risks).
Happened fromfrom_timedate and time
Start of a time range. Give Happened until with it.
Happened untiluntil_timedate and time
End of the time range. Give Happened from with it.
Recorded afterinserted_afterdate and time
Only events Censys recorded after this time, oldest first. Use instead of a time range.
Page sizepage_sizenumber
How many to return, 1 to 1000. Censys' default is 100.From 1 to 1000.
Page tokenpage_tokentext
The 'next_page_token' from an earlier run, to get the page after it.

Outputs

countnumber
How many on this page
next_page_tokentext
Pass as 'Page token' for the next page; empty on the last one
risk_eventslist
The risk events
Example output
{
  "count": 1,
  "next_page_token": "",
  "risk_events": [
    {
      "change_type": "opened",
      "id": "9472333883494777",
      "inserted_at": "2026-11-06T20:40:00Z",
      "occurred_at": "2026-11-06T20:39:09Z",
      "risk_instance": {
        "asset_type": "host",
        "description": "An end-of-life version of OpenSSL is in use.",
        "host": {
          "ip": "47.33.210.14"
        },
        "id": "ri_550",
        "rapid_response": false,
        "risk_category": "Vulnerability",
        "risk_name": "EOL OpenSSL Software",
        "risk_type_id": "eol-openssl-software",
        "severity": "MEDIUM",
        "status": "open",
        "web": {
          "hostname": "www.example.com",
          "port": 443
        }
      }
    }
  ]
}

Remove attack surface seed

Remove a seed from your attack surface. Removing one that isn't there is not an error. Free.

Inputs

SeedseedtextRequired
The seed, exactly as it was added. Pick one, or type it.

Outputs

removedtrue/false
Always true once removed
seedtext
The seed removed
Example output
{
  "removed": true,
  "seed": "example.com"
}

Search Censys' internet-wide data for hosts, certificates and web properties with a CenQL query, such as a banner, JARM, favicon hash or software. Gets one page of up to 100; each page costs a credit.

Inputs

QueryquerytextRequired
A Censys Query Language (CenQL) query, as typed in the Censys search bar.
Only these fieldsfieldslist
Return only these fields of each result, in dot notation, such as host.ip. Leave empty for every field.
Page sizepage_sizenumber
How many to return, 1 to 100. Censys' default is 100.From 1 to 100.
Page tokenpage_tokentext
The 'next_page_token' from an earlier run, to get the page after it.

Outputs

countnumber
How many on this page
hitslist
The matching assets; each names its asset_type and asset_id
next_page_tokentext
Pass as 'Page token' for the next page; empty on the last one
previous_page_tokentext
The token for the page before this one
query_duration_millisnumber
How long the search took, in milliseconds
total_hitsnumber
How many match in all
Example output
{
  "count": 1,
  "hits": [
    {
      "asset_id": "47.33.210.14",
      "asset_type": "host",
      "certificate_v1": {},
      "host_v1": {
        "matched_services": [
          {
            "port": 7547,
            "protocol": "CWMP"
          }
        ],
        "resource": {
          "autonomous_system": {
            "asn": 20115,
            "bgp_prefix": "47.33.192.0/19",
            "country_code": "US",
            "description": "ACME-20115",
            "name": "ACME-20115"
          },
          "dns": {
            "names": [
              "syn-047-033-210-014.res.acme.com"
            ],
            "reverse_dns": {
              "names": [
                "syn-047-033-210-014.res.acme.com"
              ]
            }
          },
          "ip": "47.33.210.14",
          "labels": [],
          "location": {
            "city": "Mount Pleasant",
            "continent": "North America",
            "coordinates": {
              "latitude": 43.59781,
              "longitude": -84.76751
            },
            "country": "United States",
            "country_code": "US",
            "postal_code": "48858",
            "province": "Michigan",
            "timezone": "America/Detroit"
          },
          "service_count": 1,
          "services": [
            {
              "banner_hash_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
              "port": 7547,
              "protocol": "CWMP",
              "scan_time": "2026-11-06T19:03:55Z",
              "transport_protocol": "tcp"
            }
          ],
          "whois": {
            "network": {
              "handle": "AC04",
              "name": "Acme"
            }
          }
        }
      },
      "tags": [],
      "webproperty_v1": {}
    }
  ],
  "next_page_token": "",
  "previous_page_token": "",
  "query_duration_millis": 112,
  "total_hits": 1
}

Search attack surface

Search only your attack surface's hosts, web properties and certificates with a CenQL query; a query on risk fields returns risks instead. Needs Attack Surface Management. Gets one page of up to 100.

Inputs

QueryquerytextRequired
A Censys Query Language (CenQL) query, as typed in the Censys search bar.
Only these fieldsfieldslist
Return only these fields of each result, in dot notation, such as host.ip. Leave empty for every field.
Page sizepage_sizenumber
How many to return, 1 to 100. Censys' default is 100.From 1 to 100.
Page tokenpage_tokentext
The 'next_page_token' from an earlier run, to get the page after it.

Outputs

countnumber
How many on this page
hitslist
The matching assets; each names its asset_type and asset_id
next_page_tokentext
Pass as 'Page token' for the next page; empty on the last one
previous_page_tokentext
The token for the page before this one
query_duration_millisnumber
How long the search took, in milliseconds
total_hitsnumber
How many match in all
Example output
{
  "count": 1,
  "hits": [
    {
      "asset_id": "47.33.210.14",
      "asset_type": "host",
      "certificate_v1": {},
      "host_v1": {
        "matched_services": [
          {
            "port": 7547,
            "protocol": "CWMP"
          }
        ],
        "resource": {
          "autonomous_system": {
            "asn": 20115,
            "bgp_prefix": "47.33.192.0/19",
            "country_code": "US",
            "description": "ACME-20115",
            "name": "ACME-20115"
          },
          "dns": {
            "names": [
              "syn-047-033-210-014.res.acme.com"
            ],
            "reverse_dns": {
              "names": [
                "syn-047-033-210-014.res.acme.com"
              ]
            }
          },
          "ip": "47.33.210.14",
          "labels": [],
          "location": {
            "city": "Mount Pleasant",
            "continent": "North America",
            "coordinates": {
              "latitude": 43.59781,
              "longitude": -84.76751
            },
            "country": "United States",
            "country_code": "US",
            "postal_code": "48858",
            "province": "Michigan",
            "timezone": "America/Detroit"
          },
          "service_count": 1,
          "services": [
            {
              "banner_hash_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
              "port": 7547,
              "protocol": "CWMP",
              "scan_time": "2026-11-06T19:03:55Z",
              "transport_protocol": "tcp"
            }
          ],
          "whois": {
            "network": {
              "handle": "AC04",
              "name": "Acme"
            }
          }
        }
      },
      "tags": [],
      "webproperty_v1": {}
    }
  ],
  "next_page_token": "",
  "previous_page_token": "",
  "query_duration_millis": 41,
  "total_hits": 1
}

Search collection

Search only a collection's assets with a CenQL query, so results stay inside the scope you monitor. Gets one page of up to 100.

Inputs

Collectioncollection_idtextRequired
The collection. Pick one, or give its ID from an earlier step.
QueryquerytextRequired
A Censys Query Language (CenQL) query, as typed in the Censys search bar.
Only these fieldsfieldslist
Return only these fields of each result, in dot notation, such as host.ip. Leave empty for every field.
Page sizepage_sizenumber
How many to return, 1 to 100. Censys' default is 100.From 1 to 100.
Page tokenpage_tokentext
The 'next_page_token' from an earlier run, to get the page after it.

Outputs

countnumber
How many on this page
hitslist
The matching assets; each names its asset_type and asset_id
next_page_tokentext
Pass as 'Page token' for the next page; empty on the last one
previous_page_tokentext
The token for the page before this one
query_duration_millisnumber
How long the search took, in milliseconds
total_hitsnumber
How many match in all
Example output
{
  "count": 1,
  "hits": [
    {
      "asset_id": "47.33.210.14",
      "asset_type": "host",
      "certificate_v1": {},
      "host_v1": {
        "matched_services": [
          {
            "port": 7547,
            "protocol": "CWMP"
          }
        ],
        "resource": {
          "autonomous_system": {
            "asn": 20115,
            "bgp_prefix": "47.33.192.0/19",
            "country_code": "US",
            "description": "ACME-20115",
            "name": "ACME-20115"
          },
          "dns": {
            "names": [
              "syn-047-033-210-014.res.acme.com"
            ],
            "reverse_dns": {
              "names": [
                "syn-047-033-210-014.res.acme.com"
              ]
            }
          },
          "ip": "47.33.210.14",
          "labels": [],
          "location": {
            "city": "Mount Pleasant",
            "continent": "North America",
            "coordinates": {
              "latitude": 43.59781,
              "longitude": -84.76751
            },
            "country": "United States",
            "country_code": "US",
            "postal_code": "48858",
            "province": "Michigan",
            "timezone": "America/Detroit"
          },
          "service_count": 1,
          "services": [
            {
              "banner_hash_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
              "port": 7547,
              "protocol": "CWMP",
              "scan_time": "2026-11-06T19:03:55Z",
              "transport_protocol": "tcp"
            }
          ],
          "whois": {
            "network": {
              "handle": "AC04",
              "name": "Acme"
            }
          }
        }
      },
      "tags": [],
      "webproperty_v1": {}
    }
  ],
  "next_page_token": "",
  "previous_page_token": "",
  "query_duration_millis": 54,
  "total_hits": 1
}

Update collection

Change a collection's name, query, description or who can see it. Only the fields given change. Free.

Inputs

Collectioncollection_idtextRequired
The collection. Pick one, or give its ID from an earlier step.
Namenametext
A new name. Leave empty to keep it.
Queryquerytext
A new CenQL query. Leave empty to keep it.
Descriptiondescriptiontext
A new description. Leave empty to keep it.
Who can see itprivacytext
Private to you, or shared with your organization.One of: private (Private: only you (default)), shared (Shared with your organization).

Outputs

collectionobject
The collection
Example output
{
  "collection": {
    "added_assets_24_hours": 3,
    "create_time": "2026-10-01T09:00:00Z",
    "created_by": "6f2a9a8e-1c1d-4f6b-9a2e-3c4d5e6f7a8b",
    "description": "Hosts with RDP open in our ranges",
    "id": "364133a0-53ae-4f51-82d0-17c25aed92e3",
    "name": "RDP on our network",
    "privacy": "private",
    "query": "host.services.protocol=\"RDP\" and host.autonomous_system.asn=20115",
    "removed_assets_24_hours": 1,
    "status": "active",
    "status_reason": "initial",
    "total_assets": 42
  }
}

On this page