urlscan.io User Account Help
Your user-account on urlscan.io unlocks a number of features which this page will try to explain. For help on how to use the API please refer to our API documentation.
Teams
You can create and join different Team Accounts. This will allow you to use different features and quotas available to the teams you're in as well as sharing scans with multiple users via the team. You can subscribe a team to our commercial subscriptions and have all of the team's members benefit from the available features.
Active Team
The Active Team determines which quotas and settings are used when you're using urlscan.io interactively. If you disable your active team, all interactive actions will be counted against your personal quota, and scans you perform using the UI will only be visible to you individually.
Features, Products, Limits
When you're using urlscan.io interactively, all of the available Features, Products and Limits (such as searchable fields and historical results) are merged from all your teams, regardless of your active team. The available quotas are not merged though.
Team Visibility
Scans done with an Active Team or an API-key which is associated with that team will always be visible to all members of that team.
Team Management
If you're an Owner or Admin of a team, you can invite and promote other users to the team. If you're the Owner of a team, you can also switch to managing the team account itself using the Manage Team button.
API Keys
When you're using your personal API key, you will be using your personal API quota but will retain the products, features and search-visibility of all of your teams.
When you're using an API key to submit a scan, the visibility of the scan depends on which Team the API key is associated with (see table below). The actual API-key associated with a team is only visible and useable by yourself. Other users will be able to observe the quota used by each individual API key though.
Automated Processes
When you submit a public scan that we believe contains PII (e.g. a plain or base64-encoded email address), we will restrict its visibility to "unlisted" and the scan will be counted against your "unlisted" quota.
Quotas, Features & Settings
This is how the quotas are accounted and how the settings are merged when using urlscan.io either via the UI or with an API key.
The columns show the different scenarios of how an API action is performed, either through the UI or the API and either with your personal API key or a team API key.
User UI / User API Key | User UI with Active Team | Team API Key | |
---|---|---|---|
Quota Limits & Accounting | User | Active Team | Team |
Unlisted/Private Scan Visibility | User | Active Team Members | Team Members |
Search Visibility | User + All Teams | User + All Teams | Team |
Default Visibility & Enforcement | User | Active Team | Team |
Feature Flags | User + All Teams | User + All Teams | Team |
Products | User + All Teams | User + All Teams | Team |
Searchable Fields | User + All Teams | User + All Teams | Team |
Search API Delay | min(User, All Teams) | min(User, All Teams) | Team |
Max Search Results | max(User, All Teams) | max(User, All Teams) | Team |
Historical Search Range | max(User, All Teams) | max(User, All Teams) | Team |