Your AI team, working in urlscan.io

Submit and retrieve website scans, search urlscan.io data, and manage urlscan Pro resources for threat intelligence and security investigations.

Start your company

What your team can do in urlscan.io

51 tools to work with, connected with an API key.

Close Incident

Stop ongoing scans for an active urlscan Pro incident and transition it to the closed state. Closing does not delete the incident or its history, and the incident can later be restarted.

Copy Incident

Create a separate urlscan Pro incident from an existing incident's configuration. This create operation can consume incident capacity and does not copy the source incident's stored state history; use the distinct fork operation when history must be preserved. The provider does not document whether the copied incident immediately activates ongoing scans or alerts.

Create Alert Subscription

Create a persistent scheduled or live alert subscription for saved searches. This Pro-only operation has external notification side effects: an active subscription can send email, invoke configured channels or webhooks, and create incidents. Confirm all recipients and channel or incident settings before calling.

Create Incident

Create a Pro incident that persistently monitors an observable. This high-impact operation starts ongoing external scans and can send alerts through every supplied notification channel; confirm the observable, visibility, channels, cadence, and expiration settings before calling. The operation is contract-only because the connected build account lacks the urlscan Pro Incidents entitlement.

Create Live Scan Task

Start a non-blocking temporary Live Scan on a selected scanner and return its UUID immediately without waiting for completion. This external scan side effect requires the separate urlscan.io Live Scanning entitlement; a generic Pro plan may not include it.

Create Notification Channel

Create a Pro notification channel. This operation configures external effects: active webhook channels send requests to the supplied secret URL, and active email channels send messages to the supplied recipients. Confirm the destination and activation settings before calling.

Create Saved Search

Create a reusable scans or hostnames search definition. This operation creates a persistent saved search and requires urlscan Pro; the hostnames datasource may require an additional product entitlement.

Delete Alert Subscription

Permanently delete an alert subscription by ID. This destructive operation cannot be undone and requires urlscan Pro subscriptions access plus ownership or team write permission. Use it only for a subscription created or explicitly selected by the current workflow.

Delete Saved Search

Permanently delete a saved search by ID. This destructive operation cannot be undone and requires urlscan Pro saved-search access plus ownership or team write permission. Use it only for a saved search created or explicitly selected by the current workflow.

Delete Scan Result

Permanently delete a scan owned by the connected user or team. This destructive operation cannot be reversed and requires urlscan Pro.

Download Captured FileReads only

Retrieve a captured binary file by its SHA-256 hash as a password-encrypted ZIP archive. This operation requires urlscan Pro access.

Fork Incident

Create a new Pro incident by copying an existing incident's configuration and complete stored state history. This creates a separate persistent incident; history volume and whether monitoring starts immediately are not documented.

Get Account CapabilitiesReads only

Get non-sensitive plan, product, feature, visibility, submission, and limit information for the connected urlscan.io API key.

Get API QuotasReads only

Get current products, features, query capabilities, and per-action minute, hour, and day quota usage.

Get Available BrandsReads only

List brand identifiers and metadata tracked by urlscan.io brand and phishing detection. Requires urlscan Pro brand/phishing access; the exact product and minimum plan are not documented.

Get Available Scan CountriesReads only

List scanner country codes currently accepted by the Scan API.

Get Brand SummaryReads only

Return detectable brands with detected-page totals and latest hits. This operation requires urlscan Pro access and uses the official contract only; the provider does not document its response fields.

Get Captured Response ContentReads only

Return textual content captured in a scan response, addressed by its SHA-256 hash.

Get Data Dump Download LinkReads only

Get a download URL for an offloaded data dump at a path returned by LIST_DATA_DUMPS. Data Dumps require an Enterprise or Ultimate urlscan.io plan.

Get Deprecated Phishing FeedReads only

Retrieve the deprecated urlscan Pro phishing feed in JSON, CSV, or TSV. Prefer SEARCH_SCANS for new workflows, as recommended by urlscan.io.

Get Hostname HistoryReads only

Return one page of historical Pro Hostnames observations for a hostname.

Get IncidentReads only

Get one incident's configuration, source, runtime state, and timestamps.

Get Incident StatesReads only

Retrieve the stored state history for an incident.

Get Live Scan ResourceReads only

Retrieve a temporary result, DOM, screenshot, captured response, or download from the separate urlscan.io Live Scanning product. Results are returned as JSON and DOM as text; screenshots, captured responses, and downloads are offloaded as downloadable files.

Get Notification ChannelReads only

Get one urlscan Pro notification channel by ID, preserving provider-specific metadata while filtering recognized webhook destination and credential keys.

Get Saved Search ResultsReads only

Run a urlscan Pro saved search and return its current Search API results. The provider redirect is followed automatically; this operation does not expose pagination controls.

Get Scan DOMReads only

Return the plain-text DOM snapshot captured for a completed scan.

Get Scan ResultReads only

Retrieve the complete metadata and captured request data for a completed scan UUID.

Get Scan ScreenshotReads only

Retrieve a completed urlscan.io scan screenshot as a downloadable PNG file reference.

Get Scan User AgentsReads only

List grouped browser user-agent strings available for scan submission.

Get Similar Scan ResultsReads only

Find one page of scan results structurally similar to a specified scan. Requires urlscan Pro access.

Get Subscription ResultsReads only

Resolve a urlscan Pro alert subscription and datasource to its current Search API results. The provider redirect is followed automatically; this operation does not expose pagination controls.

Get Watchable Incident AttributesReads only

List attribute values accepted when configuring incident change monitoring. Requires urlscan Pro Incidents capability; the exact minimum plan or product is not documented.

List Alert SubscriptionsReads only

List alert subscriptions configured for the current user. This operation requires urlscan Pro subscriptions access.

List Data DumpsReads only

List available urlscan.io data-dump files for a time window, file type, and date. Requires an Enterprise or Ultimate plan; availability can vary by window and file type.

List Live ScannersReads only

List Live Scanning nodes available to the connected account and their current metadata. This requires the separate urlscan.io Live Scanning product; a generic urlscan Pro plan may not include it.

List Notification ChannelsReads only

List email and webhook notification channels for the current user, filtering recognized webhook URL and credential keys. This operation requires urlscan Pro channels access.

List Saved SearchesReads only

List saved searches owned by or shared with the current user. This operation requires urlscan Pro saved-search access.

Lookup Malicious ObservableReads only

Look up malicious-scan occurrence counts and first/last seen timestamps for an IP, hostname, domain, or exact URL. Requires urlscan Pro malicious-observable access.

Purge Live Scan Result

Permanently delete a temporary result from the separate urlscan.io Live Scanning product before its normal expiration. This destructive operation cannot be undone; only use it to clean up a temporary result created by the current workflow.

Reset Scan Visibility

Remove an owned scan's visibility override and restore the visibility originally assigned at submission. This resets an override; it does not delete the scan. Requires urlscan Pro.

Restart Incident

Restart a closed urlscan Pro incident and extend its expiry. This resumes ongoing external monitoring, begins recording new incident states, and can resume alerts through the incident's configured notification channels; confirm the incident should become active again before calling. This operation is contract-only because the connected build account lacks Pro Incidents access.

Run Blocking Live Scan

Run a temporary Live Scan synchronously and return only after the provider finishes the scan. This requires the separate Live Scanning product.

Search ScansReads only

Search urlscan.io data with Elasticsearch Query String syntax and return one controllable page of results.

Store Live Scan Result

Permanently store an existing temporary Live Scan result with the selected visibility. This updates the temporary result into a durable snapshot and requires the separate urlscan.io Live Scanning entitlement; a generic urlscan Pro plan may not include it.

Submit Scan

Submit a URL for asynchronous external scanning, creating persistent result state and consuming quota. Visibility defaults to public, and free accounts have no cleanup operation. Returns the scan UUID for result and asset retrieval.

Update Alert Subscription

Replace the complete configuration of an existing alert subscription. This Pro-only PUT requires every mandatory field, not only changed values. It has external notification side effects: activating the subscription or changing recipients, channels, webhooks, or incident settings can send notifications or create incidents. Confirm the complete replacement configuration before calling.

Update Incident

Replace an existing incident's monitoring configuration and runtime options. This Pro-only PUT requires observable, visibility, and the complete channel set, not only changed values. Updating it changes ongoing external scanning and can redirect or trigger future channel alerts; confirm the complete replacement configuration before calling.

Update Notification Channel

Replace the complete configuration of an existing Pro notification channel. This operation can redirect external effects: active webhook channels send requests to the supplied secret URL, and active email channels send messages to the supplied recipients. Confirm the complete destination and activation settings before calling.

Update Saved Search

Replace the complete definition and metadata of an existing saved search. This PUT operation requires urlscan Pro saved-search access and write permission; the hostnames datasource may require an additional entitlement.

Update Scan Visibility

Change the visibility of a scan owned by the connected user or team. This operation requires a paid urlscan Pro entitlement and is contract-only, not live verified. Use DELETE_RESULT for permanent deletion.

More in Security & identity tools

See them all β†’

Your company, run by an AI team

Start your company

BRAINER

Continue to B.R.A.I.N.E.R.

Continue with Google or your email.

or