Query Converter

The Query Converter assists users transitioning from Legacy Search syntax (Censys Search Language) to Platform syntax (Censys Query Language, or CenQL). Enter a Legacy Search query into the Query Converter to identify syntax differences and view recommended changes to correct your query.

This page explains how to use the Query Converter in the Platform web UI. You can also convert queries via API.

Query Converter in the search bar

You can input Legacy Search queries in the search bar. The built-in query converter will automatically turn them into valid Platform queries.

Query Converter tab

Follow the steps below to use the Query Converter:

  1. Go to the Censys Platform Homepage and click the Query Converter tab.

  2. Enter a Legacy Search query into the Original Query field and click Convert.


Query conversion examples

The table below provides examples of Legacy Search queries converted to Platform queries using CenQL.

Legacy Search QueryPlatform Search - CenQL
ip: 1.1.1.1host.ip: 1.1.1.1
name: "censys.com"web.hostname: "censys.com"
dns.names: "censys.io"host.dns.names: "censys.io"
services.service_name: HTTPhost.services.protocol: "HTTP" or web.endpoints.endpoint_type: "HTTP"
labels: camerahost.services.hardware.type="CAMERA"
labels: ipv6host.labels.value: "IPV6"
autonomous_system.asn: 1234host.autonomous_system.asn: 1234
location.country: "Spain"host.location.country: "Spain"
services.software.product: "GitLab"host.services.software.product: "GitLab" or web.software.product: "GitLab"
services.http.response.headers: (key: 'Server' and value.headers: 'nginx')web.endpoints.http.headers: (key: "Server" and value: "nginx")
services.http.response.headers: (key: 'Server' and value.headers: 'nginx') and location.country: 'Spain'host.services.endpoints.http.headers: (key: "Server" and value: "nginx") and host.location.country: "Spain"

Additional resources

  • The Example Queries tab in the Platform is an excellent resource for learning how to build queries using CenQL.
  • The Censys Query Language docs can help you further understand CenQL.