Last updated

Incidents Search

Our Incidents feature within urlscan Observe allows you to continuously monitor specific observables and receive updates when changes occur. Incidents can be customized with options such as perpetual monitoring, custom scan intervals, stop conditions, scanner locations, and user-agents. This page provides a reference for the available fields and parameters used to create and manage Incidents via the API.

Searchable Fields

The following fields can only be searched on the Professional, Enterprise, and Ultimate plans.

Field NameTypeField semantics, features, & notes
asntextASN number the observable has been seen on
asnnamekeywordName of the ASN of the observable
countriestextScan location list
countriesPerIntervalinteger
createdAtdateDatetime of when the incident was created
domainkeywordThe root domain
expireAtdateDatetime for when the incident is due to expire
hostnamekeywordThe full hostname
incidentProfiletextThe ID of the incident profile used to create the incident
observabletextThe observable of the incident
scanIntervalintegerInterval between triggering full website scan
scanIntervalAfterMaliciousintegerThe scan interval of the incident after the hostname/domain/URL was detected as malicious
scanIntervalAfterSuspendedintegerThe scan interval of the incident after the site was suspended or taken down
scanIntervalModetextThe scan mode type
sourceIdtextID of the trigger source
sourceTypetextIncident source type
statetextCurrent incident state
stateCountintegerHow many intervals we have stored for the incident
stateSizeintegerThe size of the state internally
stopDelayInactiveintegerControl for when the incident is automatically closed
stopDelayMaliciousintegerControl for when the incident is automatically closed
stopDelaySuspendedintegerControl for when the incident is automatically closed
tldkeywordThe top level domain of the observable
typetextObservable type
uniqueIdtextUnique ID for the incident
uniqueIPsintegerCount of unique IPs observed in the incident
updatedAtdateDatetime of when the incident was updated
userAgentsPerIntervalintegerCount of user agents per scan interval
verdicttextIncident malicious or benign verdict
visibilitytextIncident visibility