Transition Guides for Free Users, Solo, and Teams Subscribers
The purpose of this document is to assist current Censys users with their transition from Legacy Search to the new Censys Platform. We now offer Free, Starter, and Enterprise tiers, with Solo and Teams plans now replaced by the Starter tier. Below each tier, you'll find a high-level description of the changes between Legacy Search and the Platform, along with links to resources for additional context and details.
Free tier
Free users can log in to the Censys Platform with the same credentials you used in Legacy Search.
Choose Censys Platform on the authentication page.
Your account information in Legacy Search has been migrated to the new Platform. To view this information, click on your initials in the upper right, select My Account, and view any of the organizational settings.
Free tier users will have a balance of 100 credits in the new Platform. To view your balance, go to Credit Management, found on the left-side navigation menu. Learn more about Censys Credits here.
Feature and data access tiers
Censys offers tiered data and feature access solutions for a wide range of users, from hobbyists to enterprise security teams. All users have a Free account that offers basic internet visibility, access to basic protocols and certificates, and limited web property data such as root endpoints.
To access more detailed data that provides deeper insights, you must upgrade to a higher tier account. Each tier builds upon comprehensive internet scanning data, offering progressively deeper scan results and context about assets and their importance to security workflows.
Censys offers three main tiers: Free, Starter, and Enterprise. A Core sub-tier of the Enterprise tier is also available. These tiers are often referred to as plans or levels.
To learn more, see Feature and Data Access Tiers.
Censys Platform syntax differences
We introduced a new data model in the Censys Platform that includes three datasets: hosts, certificates, and web properties. Search functionality in the Censys Platform was enhanced, both syntax and semantics have changed since Legacy Search. Due to schema changes, you must define the dataset by prepending your search with host.
, cert.
, or web.
.
Due to schema and syntax changes, you must modify your queries for them to return the same results.
The Censys Platform now uses a new query language that provides the following benefits:
- Universal search allows users to easily search across multiple datasets with one query.
- Search now includes a query validator that verifies syntax and assists with troubleshooting.
- Simplified regex searches and improved the use of operators.
- Wildcard no longer supported, use regex instead.
To learn more, see Censys Platform Syntax Differences.
Schema differences
Censys introduced a new data model for describing hosts, certificates, and web properties on the internet in the Censys Platform. This new data model is different from the one available in Legacy Search and features many improvements and additions. Queries and workflows that were used in Legacy Search need to be modified to return similar results in the Censys Platform.
Some of the most prominent changes include:
- A new domain-specific language and syntax, Censys Query Language (CenQL), for querying the Censys Platform datasets.
- Virtual hosts are now represented by web properties to describe and organize data for internet assets that respond to name-based scans.
- Additional context about web asset software, hardware, operating system, threats, and more to provide actionable information on what exactly mapped services and devices are, how they are configured, whether they are vulnerable, whether they are malicious, and where they live.
- Threat-related data, including data that was previously associated with the C2 label in Legacy Search datasets, is accessible to Enterprise organizations that have purchased the Threat Hunting module.
host
,cert
, orweb
have been prepended to all parsed data fields. These values indicate whether the field is present on a host, certificate, or web property asset.- Many values related to software or hardware that were previously present in the
label
field in Legacy Search can now be found instead insoftware
andsoftware.components
fields for hosts and web properties.
To learn more about schema changes, see Dataset Differences: Censys Platform vs. Legacy Search.
Upgrade to a higher tier
To upgrade to the Starter tier, you must purchase Censys credits. Credits are available for purchase directly through the Censys website, starting at 500 credits. You can purchase additional credits at any time.
Follow the instructions below to purchase credits:
- Go to the Credit Management on the sidebar.
- Click Buy Credits.
- Select the appropriate amount of credits.
- Enter your payment information and accept the Terms and Conditions.
If you upgrade to the Starter tier, your Free account remains active and will continue receiving 100 credits per month.
Solo and Teams subscribers
The Solo and Teams plans are now replaced by the Starter tier. Current subscribers will receive emails with instructions on how to migrate from their existing plan to the Starter tier on the Censys Platform.
Starter tier consumption is measured using Censys Credits. Learn more about credits here.
Feature and data access tiers
Censys offers tiered data and feature access solutions for a wide range of users, from hobbyists to enterprise security teams. All users have a Free account that offers basic internet visibility, access to basic protocols and certificates, and limited web property data such as root endpoints.
To access more detailed data that provides deeper insights, you must upgrade to a higher tier account. Each tier builds upon comprehensive internet scanning data, offering progressively deeper scan results and context about assets and their importance to security workflows.
Censys offers three main tiers: Free, Starter, and Enterprise. A Core sub-tier of the Enterprise tier is also available. These tiers are often referred to as plans or levels.
To learn more, see Feature and Data Access Tiers.
Censys Platform syntax differences
We introduced a new data model in the Censys Platform that includes three datasets: hosts, certificates, and web properties. Search functionality in the Censys Platform was enhanced, both syntax and semantics have changed since Legacy Search. Due to schema changes, you must define the dataset by prepending your search with host.
, cert.
, or web.
.
Due to schema and syntax changes, you must modify your queries for them to return the same results.
The Censys Platform now uses a new query language that provides the following benefits:
- Universal search allows users to easily search across multiple datasets with one query.
- Search now includes a query validator that verifies syntax and assists with troubleshooting.
- Simplified regex searches and improved the use of operators.
- Wildcard no longer supported, use regex instead.
To learn more, see Censys Platform Syntax Differences.
Schema differences
Censys introduced a new data model for describing hosts, certificates, and web properties on the internet in the Censys Platform. This new data model is different from the one available in Legacy Search and features many improvements and additions. Queries and workflows that were used in Legacy Search need to be modified to return similar results in the Censys Platform.
Some of the most prominent changes include:
- A new domain-specific language and syntax, Censys Query Language (CenQL), for querying the Censys Platform datasets.
- Virtual hosts are now represented by web properties to describe and organize data for internet assets that respond to name-based scans.
- Additional context about web asset software, hardware, operating system, threats, and more to provide actionable information on what exactly mapped services and devices are, how they are configured, whether they are vulnerable, whether they are malicious, and where they live.
host
,cert
, orweb
have been prepended to all parsed data fields. These values indicate whether the field is present on a host, certificate, or web property asset.- Threat-related data, including data that was previously associated with the C2 label in Legacy Search datasets, is accessible to Enterprise organizations that have purchased the Threat Hunting module
- Many values related to software or hardware that were previously present in the
label
field in Legacy Search can now be found instead insoftware
andsoftware.components
fields for hosts and web properties.
To learn more about schema changes, see Dataset Differences: Censys Platform vs. Legacy Search.
Transition to the new Censys Platform API
In addition to the new Platform, we also released the Censys Platform API. To seamlessly transition to the new API, please update the following:
- Base URL: There is a new base URL for the Censys Platform API.
- Access token: There is a new process to generate a Personal Access Token.
- Review any downstream applications that receive data from the API.
For more information about these changes, see Get Started and the Platform API Transition Guide.
Upgrade to a higher tier
To upgrade to the Enterprise tier, you must contact a Censys sales representative using the Contact Form.
Updated 8 days ago