MCP server for ScanMalware.com URL scanning, malware detection, and analysis.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional Bearer token when MCP_AUTH_TOKEN is set.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Find JavaScript files similar to the file with this content SHA-256, above threshold (default 0.7), up to limit results; exclude_exact_matches drops identical copies. Useful for finding modified versions of a known script.
Find JavaScript files similar to the file with this content SHA-256, above threshold (default 0.7), up to limit results; exclude_exact_matches drops identical copies. Useful for finding modified versions of a known script.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| threshold | number | |
| content_sha256* | string | |
| exclude_exact_matches | boolean |
{
"type": "object",
"title": "find_js_fingerprint_similar_by_hashArguments",
"required": [
"content_sha256"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 10
},
"threshold": {
"type": "number",
"title": "Threshold",
"default": 0.7
},
"content_sha256": {
"type": "string",
"title": "Content Sha256"
},
"exclude_exact_matches": {
"type": "boolean",
"title": "Exclude Exact Matches",
"default": false
}
}
}Get the AI analysis of one scan: classification (LEGITIMATE to CONFIRMED_SCAM), scam type, risk score, confidence, impersonated brand and the key evidence behind it. The analysis is produced a few minutes after the scan completes and returns not found until then. It can disagree with the scanner's own security verdict. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_ai_analysisArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}List which analysis modules ran for one scan (for example JavaScript fingerprinting and AI analysis), with each module's status, success flag and timing. Useful for checking why a result is missing. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_analyzer_resultsArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}Get platform-wide statistics for the scan analysis modules: the modules and their run counts. Describes the service, not a particular scan.
No arguments.
{
"type": "object",
"title": "get_analyzer_statsArguments",
"properties": {}
}Get the ScanMalware API's name, version, status, main endpoints and feature list.
No arguments.
{
"type": "object",
"title": "get_api_rootArguments",
"properties": {}
}Get the bot-protection and CAPTCHA services detected on a scanned page (for example Cloudflare Turnstile), with a detected flag. Phishing kits often use these to hide from scanners. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_bot_protectionArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}Get the size of ScanMalware's detection content (indicators, detection rules, ClamAV signatures) on a given date (scan_date, YYYY-MM-DD).
| Argument | Type | Description |
|---|---|---|
| scan_date* | string |
{
"type": "object",
"title": "get_capabilities_by_dateArguments",
"required": [
"scan_date"
],
"properties": {
"scan_date": {
"type": "string",
"title": "Scan Date"
}
}
}Get the clipboard writes the page attempted while it was scanned, with the event count and whether collection ran. Empty with an explanatory note when the page wrote nothing. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_clipboard_eventsArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}Get clipboard and pastejacking statistics across the archive: event totals, detections and daily activity.
No arguments.
{
"type": "object",
"title": "get_clipboard_statsArguments",
"properties": {}
}List the CPE identifiers (product and version names in the NVD format) derived from the technologies detected on a scanned page, with their source. Useful for matching against vulnerability data. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_cpe_by_scanArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}Get CPE statistics across the archive: scans with CPEs, unique CPEs, total detections, top vendors and products.
No arguments.
{
"type": "object",
"title": "get_cpe_statsArguments",
"properties": {}
}Get the certificates issued for a domain according to Certificate Transparency logs, with a found flag.
| Argument | Type | Description |
|---|---|---|
| domain* | string |
{
"type": "object",
"title": "get_ct_certificatesArguments",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"title": "Domain"
}
}
}List subdomains of a domain found through Certificate Transparency, with their DNS records (type, IP addresses, TTL) and when they were seen. Useful for finding the other hosts of a domain.
| Argument | Type | Description |
|---|---|---|
| domain* | string |
{
"type": "object",
"title": "get_ct_dns_recordsArguments",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"title": "Domain"
}
}
}List domains that Certificate Transparency and DNS data associate with an IP address, with record counts and the total.
| Argument | Type | Description |
|---|---|---|
| ip_address* | string |
{
"type": "object",
"title": "get_ct_domains_by_ipArguments",
"required": [
"ip_address"
],
"properties": {
"ip_address": {
"type": "string",
"title": "Ip Address"
}
}
}Find domains with names similar to a domain in Certificate Transparency data (for example lookalikes and typosquats), each with a certificate count and the kind of similarity.
| Argument | Type | Description |
|---|---|---|
| domain* | string |
{
"type": "object",
"title": "get_ct_similar_domainsArguments",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"title": "Domain"
}
}
}Get the certificate history of a domain from Certificate Transparency: when certificates were issued and when the certificate changed.
| Argument | Type | Description |
|---|---|---|
| domain* | string |
{
"type": "object",
"title": "get_ct_timelineArguments",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"title": "Domain"
}
}
}Get the scan history of a domain with the total count and the scans, paginated with page and limit.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| domain* | string |
{
"type": "object",
"title": "get_domain_historyArguments",
"required": [
"domain"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"domain": {
"type": "string",
"title": "Domain"
}
}
}List the recent scans of a domain and its subdomains, newest first, up to limit; status filters by scan status. Each row has matched_on: 'url' when the scan was submitted for a host under this domain, and only 'final_url' when another site redirected there. A verdict on a final_url-only row belongs to the submitted host, not to this domain.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| domain* | string | |
| status | any |
{
"type": "object",
"title": "get_domain_scansArguments",
"required": [
"domain"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"domain": {
"type": "string",
"title": "Domain"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Status",
"default": null
}
}
}Get scan counts for a domain: total, unique, completed and failed scans, first and latest scan, and scans in the last 24 hours, 7 days and 30 days.
| Argument | Type | Description |
|---|---|---|
| domain* | string |
{
"type": "object",
"title": "get_domain_statsArguments",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"title": "Domain"
}
}
}Get the favicon recorded for a scan_id: its size, MD5 and SHA-256 hashes, and the image base64-encoded. found is false when no favicon is stored for the scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_faviconArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}Get favicon statistics across the archive: total favicons, those seen in the last 24 hours and the most common hashes with sample URLs. This aggregate query can take up to 90 seconds by default.
No arguments.
{
"type": "object",
"title": "get_favicon_statsArguments",
"properties": {}
}Check whether the ScanMalware API is up. Returns the service status.
No arguments.
{
"type": "object",
"title": "get_healthArguments",
"properties": {}
}Get intrusion detection (IDS) alerts raised on the network traffic recorded during one scan, with a severity breakdown and total count. Empty when no rule fired. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_ids_alertsArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}Get statistics for an IP address across the archive: total scans, unique URLs, first and last seen, geolocation, ASN and organisation, BGP and DNS data; paginated.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| ip_address* | string |
{
"type": "object",
"title": "get_ip_statsArguments",
"required": [
"ip_address"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"ip_address": {
"type": "string",
"title": "Ip Address"
}
}
}Get the JARM TLS server fingerprints measured for the hosts in one scan, with whether each matches a known signature. A shared JARM often points to the same server software or hosting platform, so it is a weak pivot on its own. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_jarm_signaturesArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}Get JARM statistics across the archive, including the most common signatures. Common signatures usually belong to large hosting platforms.
No arguments.
{
"type": "object",
"title": "get_jarm_statsArguments",
"properties": {}
}List the JavaScript files a scanned page loaded, each with its fingerprint: hashes (SHA-256, SHA-1, MD5, normalized and fuzzy), size metrics, detected library and bundler. The include_* options add function lists, HTTP headers or ML vector details. Useful for collecting script hashes to search for elsewhere. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string | |
| include_functions | any | |
| include_http_headers | any | |
| include_vectors_info | any |
{
"type": "object",
"title": "get_js_fingerprintsArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
},
"include_functions": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Include Functions",
"default": null
},
"include_http_headers": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Include Http Headers",
"default": null
},
"include_vectors_info": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Include Vectors Info",
"default": null
}
}
}List the JavaScript libraries and versions detected across the archive, with how many scans used each; library filters to one library and min_count drops rare versions. Identifiers are lowercase names such as 'react', 'jquery' or 'nextjs'.
| Argument | Type | Description |
|---|---|---|
| library | any | |
| min_count | any |
{
"type": "object",
"title": "get_js_library_inventoryArguments",
"properties": {
"library": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Library",
"default": null
},
"min_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Min Count",
"default": null
}
}
}Get the runtime JavaScript behaviour recorded for one scan: overall risk, risk scores, number of scripts, eval and Function-constructor calls and high-risk events, with a behavioural signature and composite hash. include_detailed_events adds the individual events. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string | |
| include_detailed_events | any |
{
"type": "object",
"title": "get_js_runtime_behaviourArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
},
"include_detailed_events": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Include Detailed Events",
"default": null
}
}
}Get how many scans have runtime JavaScript fingerprints: coverage percentage and the number of unique composite hashes and signatures. Describes the service, not a scan.
No arguments.
{
"type": "object",
"title": "get_js_runtime_coverageArguments",
"properties": {}
}Check whether the runtime JavaScript analysis service is up, with its version.
No arguments.
{
"type": "object",
"title": "get_js_runtime_healthArguments",
"properties": {}
}Get platform-wide statistics for runtime JavaScript analysis: risk distribution, averages and totals of eval calls and high-risk events. Describes the service, not a scan.
No arguments.
{
"type": "object",
"title": "get_js_runtime_statsArguments",
"properties": {}
}List the code segments (functions and blocks) extracted from one scan's JavaScript, each with location, length, snippet and hashes; script_url narrows to one file, paginated with limit and offset. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| limit | any | |
| offset | integer | |
| scan_id* | string | |
| script_url | any |
{
"type": "object",
"title": "get_js_segments_by_scanArguments",
"required": [
"scan_id"
],
"properties": {
"limit": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Limit",
"default": null
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0
},
"scan_id": {
"type": "string",
"title": "Scan Id"
},
"script_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Script Url",
"default": null
}
}
}List the JavaScript code segments from one scan scored as suspicious, above min_risk_score, with location, snippet and risk details; paginated with limit and offset. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| limit | any | |
| offset | integer | |
| scan_id* | string | |
| min_risk_score | any |
{
"type": "object",
"title": "get_js_segments_suspiciousArguments",
"required": [
"scan_id"
],
"properties": {
"limit": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Limit",
"default": null
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0
},
"scan_id": {
"type": "string",
"title": "Scan Id"
},
"min_risk_score": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Min Risk Score",
"default": null
}
}
}List the JavaScript code segments from one scan that match no known library, at least min_code_length long; these are usually the page's own or a kit's code. Paginated with limit and offset. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| limit | any | |
| offset | integer | |
| scan_id* | string | |
| min_code_length | any |
{
"type": "object",
"title": "get_js_segments_unknownArguments",
"required": [
"scan_id"
],
"properties": {
"limit": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Limit",
"default": null
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0
},
"scan_id": {
"type": "string",
"title": "Scan Id"
},
"min_code_length": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Min Code Length",
"default": null
}
}
}Get one JavaScript fingerprint record by its numeric fingerprint_id: the script URL, scan, hashes, metrics and ML vector information; include_functions and include_http_headers add more detail.
| Argument | Type | Description |
|---|---|---|
| fingerprint_id* | integer | |
| include_functions | any | |
| include_http_headers | any |
{
"type": "object",
"title": "get_jsfingerprintArguments",
"required": [
"fingerprint_id"
],
"properties": {
"fingerprint_id": {
"type": "integer",
"title": "Fingerprint Id"
},
"include_functions": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Include Functions",
"default": null
},
"include_http_headers": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Include Http Headers",
"default": null
}
}
}Get statistics on bundled JavaScript across the archive for a date range: share of bundled files and the breakdown by bundler (webpack, vite, rollup and so on) and module format.
| Argument | Type | Description |
|---|---|---|
| to_date | any | |
| from_date | any |
{
"type": "object",
"title": "get_jsfingerprint_bundle_statsArguments",
"properties": {
"to_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "To Date",
"default": null
},
"from_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "From Date",
"default": null
}
}
}For each script in one scan, report how common its hash is across the archive, which separates widely used library files from rare, page-specific code. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_jsfingerprint_hash_prevalenceArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}Get statistics on JavaScript library detection across the archive for a date range: total fingerprints, detection rate and the most common libraries.
| Argument | Type | Description |
|---|---|---|
| to_date | any | |
| from_date | any | |
| min_count | any |
{
"type": "object",
"title": "get_jsfingerprint_library_statsArguments",
"properties": {
"to_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "To Date",
"default": null
},
"from_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "From Date",
"default": null
},
"min_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Min Count",
"default": null
}
}
}Find JavaScript files whose fingerprint is similar to the one with this fingerprint_id, above threshold (0 to 1), paginated with limit and offset. exclude_same_scan drops matches from the same scan. Useful for finding variants of one script.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer | |
| threshold | any | |
| fingerprint_id* | integer | |
| exclude_same_scan | any |
{
"type": "object",
"title": "get_jsfingerprint_similarArguments",
"required": [
"fingerprint_id"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0
},
"threshold": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Threshold",
"default": null
},
"fingerprint_id": {
"type": "integer",
"title": "Fingerprint Id"
},
"exclude_same_scan": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Exclude Same Scan",
"default": null
}
}
}Count how many archived JavaScript files are similar to the one with this fingerprint_id, per similarity model (composite, CodeBERT, GraphCodeBERT, AST and handcrafted features), capped at max_count. This query can take up to 90 seconds by default.
| Argument | Type | Description |
|---|---|---|
| max_count | any | |
| threshold | any | |
| fingerprint_id* | integer |
{
"type": "object",
"title": "get_jsfingerprint_similarity_countsArguments",
"required": [
"fingerprint_id"
],
"properties": {
"max_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Max Count",
"default": null
},
"threshold": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Threshold",
"default": null
},
"fingerprint_id": {
"type": "integer",
"title": "Fingerprint Id"
}
}
}Get the stored source code of one JavaScript file by its numeric fingerprint_id, with its SHA-256, URL and length. Source can be long.
| Argument | Type | Description |
|---|---|---|
| fingerprint_id* | integer |
{
"type": "object",
"title": "get_jsfingerprint_sourceArguments",
"required": [
"fingerprint_id"
],
"properties": {
"fingerprint_id": {
"type": "integer",
"title": "Fingerprint Id"
}
}
}Get the current size of ScanMalware's detection content: indicator count, malware detection rules and ClamAV signatures.
No arguments.
{
"type": "object",
"title": "get_latest_capabilitiesArguments",
"properties": {}
}Get the malware detections for files the scanned page delivered, with threat names, detection counts and the detection source. Empty when nothing was detected. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_malware_by_scanArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}Get malware detection statistics across the archive: overall and last-24-hour counts, top threats and hourly trend.
No arguments.
{
"type": "object",
"title": "get_malware_statsArguments",
"properties": {}
}Describe the network log (Chrome NetLog) for a scan_id: whether one exists, its size, and its encoding. The log itself is not returned - these are routinely tens of megabytes gzipped.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_netlogArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}Get the text read by OCR from the scan's screenshot, with language, confidence, word and character counts and any regions flagged as suspicious. Useful when page text is drawn as images. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_ocr_by_scanArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}Get OCR statistics across the archive: scans with OCR text, average confidence and length, language distribution and daily counts.
No arguments.
{
"type": "object",
"title": "get_ocr_statsArguments",
"properties": {}
}Get the Open Graph and Twitter card metadata the scanned page declared (title, description, image, site name). Phishing pages often copy a brand's metadata. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_open_graphArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}Get pastejacking findings for one scan: attempts by the page to replace what a visitor copies, a common trick for making victims paste malicious commands. Includes a detected flag and a note. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_pastejackingArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}Describe the packet capture (PCAP) recorded during one scan: whether it exists, its size, compression and content type. The capture itself is not returned. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_pcap_metadataArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}Get the current scan queue length, running scans and scans completed in the last 24 hours by visibility.
No arguments.
{
"type": "object",
"title": "get_platform_statsArguments",
"properties": {}
}List the most frequently detected web technologies over the last days (paginated).
| Argument | Type | Description |
|---|---|---|
| days | any | |
| page | integer | |
| limit | integer |
{
"type": "object",
"title": "get_popular_technologiesArguments",
"properties": {
"days": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Days",
"default": null
},
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
}
}
}Get registration data (RDAP) for the scanned domain and its IP addresses: registrar, registration and expiry dates, domain age, nameservers and status. A very young domain is a common phishing signal. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_rdapArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}List the most recent public scans, newest first (paginated with page and limit). Each row has the scan ID, URL, status, visibility and submission time. Unlisted and private scans are never included.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer |
{
"type": "object",
"title": "get_recent_scansArguments",
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
}
}
}List malware threats detected in scans during the last hours (default window set by the API), with totals and grouping by threat.
| Argument | Type | Description |
|---|---|---|
| hours | any | |
| limit | integer |
{
"type": "object",
"title": "get_recent_threatsArguments",
"properties": {
"hours": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Hours",
"default": null
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
}
}
}List YARA rule matches from scans in the last hours, each with the scan, URL, rule, category, severity and confidence.
| Argument | Type | Description |
|---|---|---|
| hours | any | |
| limit | integer |
{
"type": "object",
"title": "get_recent_yara_threatsArguments",
"properties": {
"hours": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Hours",
"default": null
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
}
}
}Get Google Safe Browsing threats found for the URLs in one scan, with a has_threats flag. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_safe_browsingArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}Get Google Safe Browsing statistics across the archive: total threats, threats in the last 7 days, scans with threats and threat types.
No arguments.
{
"type": "object",
"title": "get_safe_browsing_statsArguments",
"properties": {}
}Check one scan against threat-intelligence indicator feeds: matching IP addresses and domains the page contacted, the threat types, and a summary of total and unique matches. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_scan_iocArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}Get the progress of a running scan: current step, total steps, step name, percentage and status. Useful for checking whether a scan has finished before reading its results. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_scan_progressArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}List the user reports and votes filed about one scan (for example marked safe or malicious), with the total count; report_type filters by kind. Empty when nobody has reported the scan. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string | |
| report_type | any |
{
"type": "object",
"title": "get_scan_reportsArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
},
"report_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Report Type",
"default": null
}
}
}Get the full result document of one scan: URLs and redirects, page title, load times, links, network requests, IP addresses, JavaScript files, TLS, fuzzy hashes, screenshot hashes, favicon and the security verdict. The response is large; the compact summary is enough for a verdict. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_scan_resultArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}Get a compact summary of one scan: submitted URL, final URL after redirects, status, completion time and the security verdict (verdict text, risk level, confidence and risk factors). Useful as the first look at a scan; the verdict is empty for a few seconds after a scan completes. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_scan_summaryArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}Get screenshot statistics across the archive: total screenshots, hash coverage and the distribution of perceptual hash types.
No arguments.
{
"type": "object",
"title": "get_screenshot_statsArguments",
"properties": {}
}List the web technologies detected on a scanned page (frameworks, CMS, CDN, analytics and so on), with versions where known. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_technologies_by_scanArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}List the technologies most often detected together with a given technology, with counts; min_occurrences drops rare pairs; paginated.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| tech_name* | string | |
| min_occurrences | any |
{
"type": "object",
"title": "get_technology_combinationsArguments",
"required": [
"tech_name"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"tech_name": {
"type": "string",
"title": "Tech Name"
},
"min_occurrences": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Min Occurrences",
"default": null
}
}
}Get technology detection statistics across the archive: unique technologies, total detections and counts per category. This aggregate query can take up to 90 seconds by default.
No arguments.
{
"type": "object",
"title": "get_technology_statsArguments",
"properties": {}
}Get the raw ASN.1 structure of the TLS certificate from one scan, for detailed certificate inspection. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_tls_asn1Arguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}Get the TLS certificate the scanned site presented: subject, issuer, validity dates, whether it was valid or expired, and related details. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_tls_detailsArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}List the tracking and site keys seen on the most sites (analytics IDs, CAPTCHA keys and so on), with the tracker name, category and site count; tracker_type filters by kind.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| tracker_type | any |
{
"type": "object",
"title": "get_top_tracking_keysArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"tracker_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Tracker Type",
"default": null
}
}
}Get YARA rule matches for one scan, with a summary by severity (critical, high, medium, low) and category. Empty when no rule matched. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_yara_by_scanArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}Get the YARA rule matches recorded for one scan, with the matching rules and a summary by severity and category. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string |
{
"type": "object",
"title": "get_yara_matchesArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}Get YARA statistics across the archive: overall and last-24-hour matches, severity and category distribution and top threats.
No arguments.
{
"type": "object",
"title": "get_yara_statsArguments",
"properties": {}
}Compare the JavaScript of one scan against known libraries and report which code segments match a library, which are unknown and which look suspicious, with a per-library breakdown. Matches below min_confidence (default 0.8) are not counted; known library code is excluded unless include_known_libraries is true. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string | |
| min_confidence | number | |
| include_known_libraries | boolean |
{
"type": "object",
"title": "run_js_differential_analysisArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
},
"min_confidence": {
"type": "number",
"title": "Min Confidence",
"default": 0.8
},
"include_known_libraries": {
"type": "boolean",
"title": "Include Known Libraries",
"default": false
}
}
}List scans whose AI analysis gave a specific classification: LEGITIMATE, LOW_RISK, MODERATE_RISK, HIGH_RISK or CONFIRMED_SCAM. Each result has the URL, title, submission time and the analysis.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| classification* | string |
{
"type": "object",
"title": "search_ai_classificationArguments",
"required": [
"classification"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"classification": {
"enum": [
"LEGITIMATE",
"LOW_RISK",
"MODERATE_RISK",
"HIGH_RISK",
"CONFIRMED_SCAM"
],
"type": "string",
"title": "Classification"
}
}
}List scans that the AI analysis rated high risk, optionally above min_risk_score and min_confidence, each with URL, title and the analysis. min_risk_score is on the AI's 0-10 risk scale (default 7) and min_confidence is a 0-100 percentage (default 70).
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| min_confidence | any | |
| min_risk_score | any |
{
"type": "object",
"title": "search_ai_high_riskArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"min_confidence": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Min Confidence",
"default": null
},
"min_risk_score": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Min Risk Score",
"default": null
}
}
}List scans whose AI analysis named a given scam type, such as 'Phishing', each with URL, title, submission time and the analysis (verdict, classification, risk score). The match is on the scam type text the analysis produced.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| scam_type* | string |
{
"type": "object",
"title": "search_ai_scam_typeArguments",
"required": [
"scam_type"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"scam_type": {
"type": "string",
"title": "Scam Type"
}
}
}List scans that the security analyzer scored as high risk, highest first (paginated), each with URL, risk score, verdict, confidence and analysis time. min_risk_score raises the threshold.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| min_risk_score | any |
{
"type": "object",
"title": "search_analyzer_high_riskArguments",
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"min_risk_score": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Min Risk Score",
"default": null
}
}
}Get what the archive knows about an autonomous system (ASN number, without 'AS'): organisation, total scans, unique URLs, first and last seen and BGP prefixes; paginated.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| asn_number* | integer |
{
"type": "object",
"title": "search_by_asnArguments",
"required": [
"asn_number"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"asn_number": {
"type": "integer",
"title": "Asn Number"
}
}
}Search scans by favicon hash (paginated): a mmh3 hash by default, or the favicon's MD5 with hash_type='md5'.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| hash_type | string | |
| hash_value* | string |
{
"type": "object",
"title": "search_by_faviconArguments",
"required": [
"hash_value"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"hash_type": {
"enum": [
"mmh3",
"md5"
],
"type": "string",
"title": "Hash Type",
"default": "mmh3"
},
"hash_value": {
"type": "string",
"title": "Hash Value"
}
}
}List scans whose page content has a similar fuzzy hash (hash_type tlsh, ssdeep or sdhash; the value comes from a scan result), each with URL, title and time; paginated. Useful for finding near-identical copies of a page.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| hash_type* | string | |
| hash_value* | string |
{
"type": "object",
"title": "search_by_fuzzy_hashArguments",
"required": [
"hash_type",
"hash_value"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"hash_type": {
"enum": [
"tlsh",
"ssdeep",
"sdhash"
],
"type": "string",
"title": "Hash Type"
},
"hash_value": {
"type": "string",
"title": "Hash Value"
}
}
}List scans of pages served from an IP address (paginated), each with scan ID, URL and time. On shared hosting and CDNs an IP serves many unrelated sites, so a match is not evidence of a connection.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| ip_address* | string |
{
"type": "object",
"title": "search_by_ipArguments",
"required": [
"ip_address"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"ip_address": {
"type": "string",
"title": "Ip Address"
}
}
}List scans whose server presented this JARM TLS fingerprint (paginated). Large hosting platforms share JARMs across many unrelated sites, so check what the matches have in common.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| jarm_signature* | string |
{
"type": "object",
"title": "search_by_jarmArguments",
"required": [
"jarm_signature"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"jarm_signature": {
"type": "string",
"title": "Jarm Signature"
}
}
}List the scanned domains that use a given nameserver, with totals and counts per top-level domain. Useful for finding domains registered together.
| Argument | Type | Description |
|---|---|---|
| nameserver* | string |
{
"type": "object",
"title": "search_by_nameserverArguments",
"required": [
"nameserver"
],
"properties": {
"nameserver": {
"type": "string",
"title": "Nameserver"
}
}
}List scans of domains registered through a given registrar (paginated), with the total. Common registrars match very many domains.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| registrar_name* | string |
{
"type": "object",
"title": "search_by_registrarArguments",
"required": [
"registrar_name"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"registrar_name": {
"type": "string",
"title": "Registrar Name"
}
}
}List scans whose screenshot has this perceptual hash (hash_type ahash, phash, dhash, whash, color_hash or crop_resistant), optionally within similarity_threshold, each with URL, title and time; paginated. Useful for finding pages that look the same.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| hash_type* | string | |
| hash_value* | string | |
| similarity_threshold | any |
{
"type": "object",
"title": "search_by_screenshot_hashArguments",
"required": [
"hash_type",
"hash_value"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"hash_type": {
"enum": [
"ahash",
"phash",
"dhash",
"whash",
"color_hash",
"crop_resistant"
],
"type": "string",
"title": "Hash Type"
},
"hash_value": {
"type": "string",
"title": "Hash Value"
},
"similarity_threshold": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Similarity Threshold",
"default": null
}
}
}Find scans with a CPE identifier matching a pattern such as 'cpe:2.3:a:facebook:react' (paginated). Useful for finding sites running a given product.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| cpe_pattern* | string |
{
"type": "object",
"title": "search_cpeArguments",
"required": [
"cpe_pattern"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"cpe_pattern": {
"type": "string",
"title": "Cpe Pattern"
}
}
}List scans whose favicon has this mmh3 hash (the same convention as Shodan's http.favicon.hash), each with the page URL, title and favicon details; paginated. Phishing kits often reuse one favicon across many hosts.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| mmh3_hash* | integer |
{
"type": "object",
"title": "search_favicon_mmh3Arguments",
"required": [
"mmh3_hash"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"mmh3_hash": {
"type": "integer",
"title": "Mmh3 Hash"
}
}
}Find JavaScript bundles built with a given bundler (webpack, vite, rollup, esbuild and so on), optionally by bundle format and detection confidence, with totals, format breakdown and average size; paginated with page and per_page.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| per_page | integer | |
| bundler_type* | string | |
| bundle_format | any | |
| min_confidence | any | |
| include_libraries | any |
{
"type": "object",
"title": "search_js_fingerprint_by_bundlerArguments",
"required": [
"bundler_type"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"per_page": {
"type": "integer",
"title": "Per Page",
"default": 20
},
"bundler_type": {
"type": "string",
"title": "Bundler Type"
},
"bundle_format": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Bundle Format",
"default": null
},
"min_confidence": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Min Confidence",
"default": null
},
"include_libraries": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Include Libraries",
"default": null
}
}
}Find JavaScript served from a given CDN (for example 'cloudflare' or 'jsdelivr'), with totals, the top serving domains and cache status; unpinned_only keeps scripts loaded without a fixed version.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| cdn_type* | string | |
| unpinned_only | any | |
| cdn_cache_status | any |
{
"type": "object",
"title": "search_js_fingerprint_by_cdnArguments",
"required": [
"cdn_type"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"cdn_type": {
"type": "string",
"title": "Cdn Type"
},
"unpinned_only": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Unpinned Only",
"default": null
},
"cdn_cache_status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Cdn Cache Status",
"default": null
}
}
}Find JavaScript files whose fuzzy hash is close to this one, above min_similarity, up to limit results. Fuzzy hashes match files that differ in small parts, such as a kit with a changed configuration.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| fuzzy_hash* | string | |
| min_similarity | any |
{
"type": "object",
"title": "search_js_fingerprint_by_fuzzy_hashArguments",
"required": [
"fuzzy_hash"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"fuzzy_hash": {
"type": "string",
"title": "Fuzzy Hash"
},
"min_similarity": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Min Similarity",
"default": null
}
}
}Find scanned JavaScript detected as a given library (for example 'react', 'jquery' or 'nextjs'; 'Next.js' is accepted for 'nextjs'), optionally one version or a version pattern, with a version breakdown and CDN distribution; paginated with page and per_page.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| version | any | |
| per_page | integer | |
| library_name* | string | |
| min_confidence | any | |
| version_pattern | any | |
| include_cdn_only | any |
{
"type": "object",
"title": "search_js_fingerprint_by_libraryArguments",
"required": [
"library_name"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Version",
"default": null
},
"per_page": {
"type": "integer",
"title": "Per Page",
"default": 20
},
"library_name": {
"type": "string",
"title": "Library Name"
},
"min_confidence": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Min Confidence",
"default": null
},
"version_pattern": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Version Pattern",
"default": null
},
"include_cdn_only": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Include Cdn Only",
"default": null
}
}
}Find scanned JavaScript detected as one exact library version, with the total and the matching scripts; include_deprecated and group_by_url adjust the results. Useful for finding sites running a vulnerable version.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| library* | string | |
| version* | string | |
| group_by_url | any | |
| include_deprecated | any |
{
"type": "object",
"title": "search_js_fingerprint_by_library_versionArguments",
"required": [
"library",
"version"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"library": {
"type": "string",
"title": "Library"
},
"version": {
"type": "string",
"title": "Version"
},
"group_by_url": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Group By Url",
"default": null
},
"include_deprecated": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Include Deprecated",
"default": null
}
}
}Look up a JavaScript file by MD5 across the archive and report its prevalence: total matches, unique scans, first and last seen, a prevalence label and the matching scripts; include_scans adds the scans, from_date and to_date limit the period.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| to_date | any | |
| from_date | any | |
| hash_value* | string | |
| include_scans | any |
{
"type": "object",
"title": "search_js_fingerprint_by_md5Arguments",
"required": [
"hash_value"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"to_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "To Date",
"default": null
},
"from_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "From Date",
"default": null
},
"hash_value": {
"type": "string",
"title": "Hash Value"
},
"include_scans": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Include Scans",
"default": null
}
}
}Look up JavaScript by normalized hash (computed after whitespace and formatting are removed, so reformatted copies still match) and report prevalence: total matches, unique scans, first and last seen and the matching scripts.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| to_date | any | |
| from_date | any | |
| hash_value* | string | |
| include_scans | any |
{
"type": "object",
"title": "search_js_fingerprint_by_normalized_hashArguments",
"required": [
"hash_value"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"to_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "To Date",
"default": null
},
"from_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "From Date",
"default": null
},
"hash_value": {
"type": "string",
"title": "Hash Value"
},
"include_scans": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Include Scans",
"default": null
}
}
}Find JavaScript by the type of web server that served it (for example 'nginx' or 'microsoft'), with the matching scripts; include_headers adds the HTTP headers. The total can be a lower bound.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| server_type* | string | |
| include_headers | any |
{
"type": "object",
"title": "search_js_fingerprint_by_serverArguments",
"required": [
"server_type"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"server_type": {
"type": "string",
"title": "Server Type"
},
"include_headers": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Include Headers",
"default": null
}
}
}Look up a JavaScript file by SHA-1 across the archive and report its prevalence: total matches, unique scans, first and last seen, a prevalence label and the matching scripts; include_scans adds the scans, from_date and to_date limit the period.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| to_date | any | |
| from_date | any | |
| hash_value* | string | |
| include_scans | any |
{
"type": "object",
"title": "search_js_fingerprint_by_sha1Arguments",
"required": [
"hash_value"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"to_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "To Date",
"default": null
},
"from_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "From Date",
"default": null
},
"hash_value": {
"type": "string",
"title": "Hash Value"
},
"include_scans": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Include Scans",
"default": null
}
}
}Look up a JavaScript file by SHA-256 across the archive and report its prevalence: total matches, unique scans, first and last seen, a prevalence label and the matching scripts; include_scans adds the scans, from_date and to_date limit the period. A rare hash shared by several phishing pages usually means one kit.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| to_date | any | |
| from_date | any | |
| hash_value* | string | |
| include_scans | any |
{
"type": "object",
"title": "search_js_fingerprint_by_sha256Arguments",
"required": [
"hash_value"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"to_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "To Date",
"default": null
},
"from_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "From Date",
"default": null
},
"hash_value": {
"type": "string",
"title": "Hash Value"
},
"include_scans": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Include Scans",
"default": null
}
}
}List scanned JavaScript scored as obfuscated, filtered by score range, classification and minimum code length; exclude_libraries drops known library code. min_score and max_score are obfuscation scores from 0 to 1 (defaults 0.7 and 1.0). Paginated with page and per_page.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| per_page | integer | |
| max_score | any | |
| min_score | any | |
| classification | any | |
| min_code_length | any | |
| exclude_libraries | any |
{
"type": "object",
"title": "search_js_fingerprint_obfuscatedArguments",
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"per_page": {
"type": "integer",
"title": "Per Page",
"default": 20
},
"max_score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Max Score",
"default": null
},
"min_score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Min Score",
"default": null
},
"classification": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Classification",
"default": null
},
"min_code_length": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Min Code Length",
"default": null
},
"exclude_libraries": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Exclude Libraries",
"default": null
}
}
}List scanned JavaScript files that match code-pattern filters: has_eval, has_crypto, high_entropy, no_library and cdn_mismatch, where false selects files without the pattern and filters can be combined. With no filter given, has_eval=true is applied. Each result has the fingerprint ID, scan, script URL, code length, obfuscation score and the patterns detected.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| has_eval | any | |
| has_crypto | any | |
| no_library | any | |
| cdn_mismatch | any | |
| high_entropy | any |
{
"type": "object",
"title": "search_js_fingerprint_patternsArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"has_eval": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Has Eval",
"default": null
},
"has_crypto": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Has Crypto",
"default": null
},
"no_library": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "No Library",
"default": null
},
"cdn_mismatch": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Cdn Mismatch",
"default": null
},
"high_entropy": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "High Entropy",
"default": null
}
}
}List groups of scans whose runtime JavaScript behaves alike (possible malware families), with clusters of at least min_cluster_size scans (default 2) at similarity_threshold or above (0 to 1, default 0.95). When the service has clustering switched off, status is 'disabled' and no families are returned.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| min_cluster_size | any | |
| similarity_threshold | any |
{
"type": "object",
"title": "search_js_malware_familiesArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"min_cluster_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Min Cluster Size",
"default": null
},
"similarity_threshold": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Similarity Threshold",
"default": null
}
}
}List scans by the obfuscation signals their runtime JavaScript showed, newest analysis first: overall risk, maximum and average risk score, eval and Function constructor calls and high-risk events. Optional filters are risk_level (such as 'high' or 'critical'), min_risk_score (0-100) and has_eval; with none, the most recently analysed scans are listed.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| has_eval | any | |
| risk_level | any | |
| min_risk_score | any |
{
"type": "object",
"title": "search_js_obfuscationArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"has_eval": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Has Eval",
"default": null
},
"risk_level": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Risk Level",
"default": null
},
"min_risk_score": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Min Risk Score",
"default": null
}
}
}Find scans whose runtime JavaScript behaviour has this composite hash, each with the target URL, overall risk and time. The same composite hash across hosts usually means the same kit.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| composite_hash* | string |
{
"type": "object",
"title": "search_js_runtime_by_composite_hashArguments",
"required": [
"composite_hash"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"composite_hash": {
"type": "string",
"title": "Composite Hash"
}
}
}Find scans with this behavioural signature (for example 'setTimeout:30|fetch:4|complex'), each with the target URL, overall risk and time. An uncached query can take up to 90 seconds by default.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| signature* | string |
{
"type": "object",
"title": "search_js_runtime_by_signatureArguments",
"required": [
"signature"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"signature": {
"type": "string",
"title": "Signature"
}
}
}Find scans whose runtime JavaScript behaviour is similar to this scan's, above min_similarity; include_self keeps the scan itself. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| scan_id* | string | |
| include_self | any | |
| min_similarity | any |
{
"type": "object",
"title": "search_js_runtime_similarArguments",
"required": [
"scan_id"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"scan_id": {
"type": "string",
"title": "Scan Id"
},
"include_self": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Include Self",
"default": null
},
"min_similarity": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Min Similarity",
"default": null
}
}
}Find code segments with this exact code hash across the archive, with the scans and scripts they appear in; paginated with limit and offset.
| Argument | Type | Description |
|---|---|---|
| limit | any | |
| offset | integer | |
| code_hash* | string |
{
"type": "object",
"title": "search_js_segments_by_hashArguments",
"required": [
"code_hash"
],
"properties": {
"limit": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Limit",
"default": null
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0
},
"code_hash": {
"type": "string",
"title": "Code Hash"
}
}
}Find code segments with this normalized hash (formatting-independent) across the archive, with the scans and scripts they appear in; paginated with limit and offset.
| Argument | Type | Description |
|---|---|---|
| limit | any | |
| offset | integer | |
| normalized_hash* | string |
{
"type": "object",
"title": "search_js_segments_by_normalized_hashArguments",
"required": [
"normalized_hash"
],
"properties": {
"limit": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Limit",
"default": null
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0
},
"normalized_hash": {
"type": "string",
"title": "Normalized Hash"
}
}
}Paginated list (limit and offset) of archived script fingerprints built with a given bundler, each with scan, page URL and script URL.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer | |
| bundler* | string |
{
"type": "object",
"title": "search_jsfingerprints_by_bundlerArguments",
"required": [
"bundler"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0
},
"bundler": {
"type": "string",
"title": "Bundler"
}
}
}Paginated list (limit and offset) of archived script fingerprints whose fuzzy hash matches this value, each with scan, page URL and script URL. An empty list means no close match.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer | |
| fuzzy_hash* | string |
{
"type": "object",
"title": "search_jsfingerprints_by_fuzzy_hashArguments",
"required": [
"fuzzy_hash"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0
},
"fuzzy_hash": {
"type": "string",
"title": "Fuzzy Hash"
}
}
}Paginated list (limit and offset) of archived script fingerprints detected as a given library, each with scan, page URL, script URL and version.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer | |
| library* | string |
{
"type": "object",
"title": "search_jsfingerprints_by_libraryArguments",
"required": [
"library"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0
},
"library": {
"type": "string",
"title": "Library"
}
}
}Paginated list (limit and offset) of archived script fingerprints detected as one library version, each with scan, page URL and script URL.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer | |
| library* | string | |
| version* | string |
{
"type": "object",
"title": "search_jsfingerprints_by_library_versionArguments",
"required": [
"library",
"version"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0
},
"library": {
"type": "string",
"title": "Library"
},
"version": {
"type": "string",
"title": "Version"
}
}
}Paginated list (limit and offset) of archived script fingerprints with this MD5, each with scan, page URL, scan time, script URL and hashes.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer | |
| hash_value* | string |
{
"type": "object",
"title": "search_jsfingerprints_by_md5Arguments",
"required": [
"hash_value"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0
},
"hash_value": {
"type": "string",
"title": "Hash Value"
}
}
}Paginated list (limit and offset) of archived script fingerprints with this normalized hash (formatting-independent), each with scan, page URL and script URL.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer | |
| hash_value* | string |
{
"type": "object",
"title": "search_jsfingerprints_by_normalized_hashArguments",
"required": [
"hash_value"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0
},
"hash_value": {
"type": "string",
"title": "Hash Value"
}
}
}Paginated list (limit and offset) of archived script fingerprints with this SHA-1, each with scan, page URL, scan time, script URL and hashes.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer | |
| hash_value* | string |
{
"type": "object",
"title": "search_jsfingerprints_by_sha1Arguments",
"required": [
"hash_value"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0
},
"hash_value": {
"type": "string",
"title": "Hash Value"
}
}
}Paginated list (limit and offset) of archived script fingerprints with this SHA-256, each with scan, page URL, scan time, script URL and hashes.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer | |
| hash_value* | string |
{
"type": "object",
"title": "search_jsfingerprints_by_sha256Arguments",
"required": [
"hash_value"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0
},
"hash_value": {
"type": "string",
"title": "Hash Value"
}
}
}Search OCR text (paginated). q must contain at least 3 characters after trimming. This query can take up to 90 seconds by default.
| Argument | Type | Description |
|---|---|---|
| q* | string | |
| page | integer | |
| limit | integer |
{
"type": "object",
"title": "search_ocrArguments",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"title": "Q"
},
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
}
}
}Search the text read by OCR from scan screenshots for a pattern (paginated); case_sensitive controls matching. Useful for finding pages that show the same lure text as an image.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| pattern* | string | |
| case_sensitive | boolean |
{
"type": "object",
"title": "search_ocr_patternArguments",
"required": [
"pattern"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"pattern": {
"type": "string",
"title": "Pattern"
},
"case_sensitive": {
"type": "boolean",
"title": "Case Sensitive",
"default": false
}
}
}Search the archive of public scans by text in the URL, domain or page title (paginated); q needs at least 3 characters and search_type narrows the match (default 'all'). Each result has the scan ID, URL, status, title, submission time and hosting ASN.
| Argument | Type | Description |
|---|---|---|
| q* | string | |
| page | integer | |
| limit | integer | |
| search_type | string |
{
"type": "object",
"title": "search_scansArguments",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"title": "Q"
},
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"search_type": {
"type": "string",
"title": "Search Type",
"default": "all"
}
}
}Search scans by meaning rather than exact words, comparing the query with scanned page content (for example 'bank login page asking for card details'). threshold (default 0.7) is the minimum similarity; an empty result means nothing was similar enough.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| query* | string | |
| threshold | number |
{
"type": "object",
"title": "search_semanticArguments",
"required": [
"query"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"query": {
"type": "string",
"title": "Query"
},
"threshold": {
"type": "number",
"title": "Threshold",
"default": 0.7
}
}
}Find scans that look like this one by screenshot similarity, favicon or fuzzy page hash (methods, default screenshot), each with URL, final URL, title and what it matched by; paginated. Useful for finding copies of a phishing page on other hosts. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| methods | any | |
| scan_id* | string |
{
"type": "object",
"title": "search_similar_scansArguments",
"required": [
"scan_id"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"methods": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Methods",
"default": null
},
"scan_id": {
"type": "string",
"title": "Scan Id"
}
}
}Find screenshots within max_distance (Hamming distance, default 3) of an integer perceptual hash (hash_type, default phash), each with scan, URL, title, distance and similarity score.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| hash_type | string | |
| hash_value* | integer | |
| max_distance | integer |
{
"type": "object",
"title": "search_similar_screenshotsArguments",
"required": [
"hash_value"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"hash_type": {
"type": "string",
"title": "Hash Type",
"default": "phash"
},
"hash_value": {
"type": "integer",
"title": "Hash Value"
},
"max_distance": {
"type": "integer",
"title": "Max Distance",
"default": 3
}
}
}List scans where the page wrote suspicious content to the clipboard (for example PowerShell commands), each with URL, event count, reason and time; pattern filters the content; paginated.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| pattern | any |
{
"type": "object",
"title": "search_suspicious_clipboardArguments",
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"pattern": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Pattern",
"default": null
}
}
}Search the web technologies detected across the archive by name (q) or category, each with how many scans used it and when it was last seen; paginated.
| Argument | Type | Description |
|---|---|---|
| q | any | |
| page | integer | |
| limit | integer | |
| category | any |
{
"type": "object",
"title": "search_technologiesArguments",
"properties": {
"q": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Q",
"default": null
},
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Category",
"default": null
}
}
}Find scans that embed a given tracking or site key, such as an analytics ID or a CAPTCHA site key (tracker_type and key), sorted latest or oldest; paginated. A shared key often ties sites to one operator.
| Argument | Type | Description |
|---|---|---|
| key* | string | |
| page | integer | |
| sort | any | |
| limit | integer | |
| tracker_type* | string |
{
"type": "object",
"title": "search_tracking_keyArguments",
"required": [
"tracker_type",
"key"
],
"properties": {
"key": {
"type": "string",
"title": "Key"
},
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"sort": {
"anyOf": [
{
"enum": [
"latest",
"oldest"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Sort",
"default": null
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"tracker_type": {
"type": "string",
"title": "Tracker Type"
}
}
}Submit a URL to ScanMalware to be rendered and analysed in a sandboxed browser; returns the new scan_id. scan_type is required and sets who can see the result: 'public' lists the URL and its results in the public feed, visible to anyone and to search engines; 'unlisted' keeps the scan out of public listings, but anyone with its link can open it; 'private' limits the result to the ScanMalware account of this server's SCANMALWARE_BEARER_TOKEN and is rejected when no token is configured. Wraps POST /api/v1/scan of the ScanMalware API, documented at https://scanmalware.com/api-docs.
| Argument | Type | Description |
|---|---|---|
| url* | string | |
| options | any | |
| scan_type* | string | |
| user_agent | any |
{
"type": "object",
"title": "submit_scanArguments",
"required": [
"url",
"scan_type"
],
"properties": {
"url": {
"type": "string",
"title": "Url"
},
"options": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Options",
"default": null
},
"scan_type": {
"enum": [
"public",
"unlisted",
"private"
],
"type": "string",
"title": "Scan Type"
},
"user_agent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "User Agent",
"default": null
}
}
}Vote on a scan, as the Mark as Safe and Mark as Malicious buttons on its result page do: report_type 'positive_feedback' marks the scanned page as safe and 'malware' marks it as malicious. report_details is an optional note of up to 1000 characters. Votes are recorded as crowd feedback on the scan and are rate-limited per client IP. The website's other report types (phishing, spam, copyright and so on) need a captcha and are not available here.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string | |
| report_type* | string | |
| report_details | any |
{
"type": "object",
"title": "submit_scan_reportArguments",
"required": [
"scan_id",
"report_type"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
},
"report_type": {
"enum": [
"positive_feedback",
"malware"
],
"type": "string",
"title": "Report Type"
},
"report_details": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Report Details",
"default": null
}
}
}Wait for a submitted scan to finish by polling its status every poll_interval_s seconds, up to timeout_s seconds (default 180). Returns the final compact summary (URL, final URL, status, completion time and the security verdict), or the last known status with timeout set to true if the scan is still running. The security verdict is computed after the scan completes, usually within about a minute: until then verdict_pending is true and the verdict fields are empty, so a risk score of 0 is not yet a verdict. scan_id is the UUID of a ScanMalware scan.
| Argument | Type | Description |
|---|---|---|
| scan_id* | string | |
| timeout_s | number | |
| poll_interval_s | number |
{
"type": "object",
"title": "wait_for_scanArguments",
"required": [
"scan_id"
],
"properties": {
"scan_id": {
"type": "string",
"title": "Scan Id"
},
"timeout_s": {
"type": "number",
"title": "Timeout S",
"default": 180
},
"poll_interval_s": {
"type": "number",
"title": "Poll Interval S",
"default": 2
}
}
}