Collections

Collections allow you to track and monitor the results of a Censys query over time. You can save time and resources by creating a collection and configuring alerts to track new assets that match your queries. Collections track both additions and removals to assets that match your queries.

Collection usage deducts credits from your balance. The cost is based on the number of assets monitored each day or 100 assets, whichever is greater. Users are charged for searching within a collection, selecting a filter, and viewing assets included in the collection. To learn more, see Credit Costs for Collections.

With Collections, you can:

• Focus on what matters: Easily isolate and review newly discovered assets added to your collections, allowing you to prioritize your efforts on the most recent changes.
• Automate workflows: Configure webhooks to receive real-time alerts for any changes within your collections, such as new assets added or assets removed. This enables you to automate your workflows to reduce manual effort.
• Explore trends: Track the history of your collections and monitor how they evolve over time. This helps you understand trends and patterns of a query and explore Censys historical data with ease.

Prerequisites

Starter tier

The following limitations apply to Starter tier.

• Organizations can create a maximum of 2 collections.
• Can create webhooks.
• Cannot share collections.

📘

Note

Collections are unavailable for the Free tier.

Permissions

Organizational admins

• Create a collection.
• View shared and unshared collections.
• Share, unshare, or edit a collection's Details.
• Create, edit, or delete a webhook.

Members

• Create a collection.
• Share a collection.
• View shared collections.

How Collections work

As new information about assets is added to or removed from the Censys Internet Map, Censys evaluates whether the changes affect any assets in a collection:

• If a new asset matches the query, it is added to the collection, triggering an Asset Added Event.
• If an existing asset no longer matches the query, it is removed from the collection, triggering an Asset Removed Event.

📘

Note

Take the Collections lesson in the Censys Academy to see use-cases and learn more about the feature.

Collection updates

Censys continuously scans the internet for new and removed assets. Collections are updated as scanning results are processed. This means that assets are added and removed from collections on a continuous basis.

This ensures that collections always reflect the most current view of relevant assets. The screenshot below shows a list of current collections for an org. to the right, New Assets count is displayed.