ZAP API UI

Component: spider

Views

addedNodes (scanId ) Returns a list of the names of the nodes added to the Sites tree by the specified scan.
allUrlsReturns a list of unique URLs from the history table based on HTTP messages added by the Spider.
domainsAlwaysInScopeGets all the domains that are always in scope. For each domain the following are shown: the index, the value (domain), if enabled, and if specified as a regex.
excludedFromScanGets the regexes of URLs excluded from the spider scans.
fullResults (scanId* )
optionAcceptCookiesGets whether or not a spider process should accept cookies while spidering.
optionDomainsAlwaysInScopeDeprecated API Endpoint. Its use is discouraged, it will be removed in a future version.
Use view domainsAlwaysInScope instead.
optionDomainsAlwaysInScopeEnabledDeprecated API Endpoint. Its use is discouraged, it will be removed in a future version.
Use view domainsAlwaysInScope instead.
optionHandleODataParametersVisited
optionHandleParameters
optionMaxChildrenGets the maximum number of child nodes (per node) that can be crawled, 0 means no limit.
optionMaxDepthGets the maximum depth the spider can crawl, 0 if unlimited.
optionMaxDuration
optionMaxParseSizeBytesGets the maximum size, in bytes, that a response might have to be parsed, or 0 for unlimited.
optionMaxScansInUI
optionParseComments
optionParseDsStore
optionParseGit
optionParseRobotsTxt
optionParseSVNEntries
optionParseSitemapXml
optionPostForm
optionProcessForm
optionSendRefererHeaderGets whether or not the 'Referer' header should be sent while spidering.
optionShowAdvancedDialog
optionSkipURLString
optionThreadCount
optionUserAgent
results (scanId )
scans
status (scanId )

Actions

addDomainAlwaysInScope (value* isRegex isEnabled ) Adds a new domain that's always in scope, using the specified value. Optionally sets if the new entry is enabled (default, true) and whether or not the new value is specified as a regex (default, false).
clearExcludedFromScanClears the regexes of URLs excluded from the spider scans.
disableAllDomainsAlwaysInScopeDisables all domains that are always in scope.
enableAllDomainsAlwaysInScopeEnables all domains that are always in scope.
excludeFromScan (regex* ) Adds a regex of URLs that should be excluded from the spider scans.
modifyDomainAlwaysInScope (idx* value isRegex isEnabled ) Modifies a domain that's always in scope. Allows to modify the value, if enabled or if a regex. The domain is selected with its index, which can be obtained with the view domainsAlwaysInScope.
pause (scanId* )
pauseAllScans
removeAllScans
removeDomainAlwaysInScope (idx* ) Removes a domain that's always in scope, with the given index. The index can be obtained with the view domainsAlwaysInScope.
removeScan (scanId* )
resume (scanId* )
resumeAllScans
scan (url maxChildren recurse contextName subtreeOnly ) Runs the spider against the given URL (or context). Optionally, the 'maxChildren' parameter can be set to limit the number of children scanned, the 'recurse' parameter can be used to prevent the spider from seeding recursively, the parameter 'contextName' can be used to constrain the scan to a Context and the parameter 'subtreeOnly' allows to restrict the spider under a site's subtree (using the specified 'url').
scanAsUser (contextId* userId* url maxChildren recurse subtreeOnly ) Runs the spider from the perspective of a User, obtained using the given Context ID and User ID. See 'scan' action for more details.
setOptionAcceptCookies (Boolean* ) Sets whether or not a spider process should accept cookies while spidering.
setOptionHandleODataParametersVisited (Boolean* )
setOptionHandleParameters (String* )
setOptionMaxChildren (Integer* ) Sets the maximum number of child nodes (per node) that can be crawled, 0 means no limit.
setOptionMaxDepth (Integer* ) Sets the maximum depth the spider can crawl, 0 for unlimited depth.
setOptionMaxDuration (Integer* )
setOptionMaxParseSizeBytes (Integer* ) Sets the maximum size, in bytes, that a response might have to be parsed. This allows the spider to skip big responses/files.
setOptionMaxScansInUI (Integer* )
setOptionParseComments (Boolean* )
setOptionParseDsStore (Boolean* )
setOptionParseGit (Boolean* )
setOptionParseRobotsTxt (Boolean* )
setOptionParseSVNEntries (Boolean* )
setOptionParseSitemapXml (Boolean* )
setOptionPostForm (Boolean* )
setOptionProcessForm (Boolean* )
setOptionSendRefererHeader (Boolean* ) Sets whether or not the 'Referer' header should be sent while spidering.
setOptionShowAdvancedDialog (Boolean* )
setOptionSkipURLString (String* )
setOptionThreadCount (Integer* )
setOptionUserAgent (String* )
stop (scanId )
stopAllScans