ScanMalware API
Scan URLs in a sandboxed browser and search past scans by domain, IP, ASN, JARM or favicon hash
Identity & security#anti-malware
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Scan URLs in a sandboxed browser and search past scans by domain, IP, ASN, JARM or favicon hash
Endpoints 246
statistics
- GETGet Stats
/api/v1/statsGet system statistics - GETGet Latest Capabilities
/api/v1/stats/capabilities/latestGet latest detection capabilities report from JSONL file - GETGet Capabilities By Date
/api/v1/stats/capabilities/by-date?scan_date=stringGet detection capabilities for a specific date, or nearest date if no exact match - GETGet Site Stats
/api/v1/site-statsPublic statistics for the chosen time window: scan volume, malicious sites by IP, network, parent domain, hosting platform, TLD, country and city, threat… - GETGet Site Script Stats
/api/v1/site-stats/scriptsJavaScript statistics for the chosen time window: the most loaded third-party script hosts and script URLs, the most common first-party script paths, and the… - GETGet Site Tls Stats
/api/v1/site-stats/tlsTLS server fingerprint statistics for the chosen time window: the most common JARM and JA4S fingerprints across scanned websites, and the ones seen on the… - GETGet Site Traffic Stats
/api/v1/site-stats/trafficSite traffic for the chosen time window: the most viewed public scans and the countries visitors come from (both as rankings), and the registered domains and…
scan-statistics
- GETGet Scan Statistics
/api/v1/scan-statisticsGet pre-computed scan statistics. Returns comprehensive scan statistics including: Total scans and breakdown by status Scans by type (public/api) Time-based… - GETGet Quick Stats
/api/v1/scan-statistics/quickGet ultra-fast overview statistics. Performance: Sub-millisecond response time Returns only the most essential counts for dashboard overview. - GETGet Stats By Status
/api/v1/scan-statistics/by-statusGet scan counts grouped by status. Returns breakdown of scans by their current status (completed, pending, processing, failed). - GETGet Stats By Type
/api/v1/scan-statistics/by-typeGet scan counts grouped by type. Returns breakdown of scans by type (public, api). - GETGet Stats By Time
/api/v1/scan-statistics/time-periodsGet scan counts by time period. Returns counts for different time windows (24 hours, 7 days, 30 days) and total. - GETGet Dashboard Stats
/api/v1/scan-statistics/dashboardGet comprehensive statistics optimized for dashboard display. Returns all statistics in a dashboard-friendly format with computed percentages, rates, and…
favicon
- GETSearch By Favicon Mmh3
/api/v1/favicon/search/:mmh3_hashSearch for websites with the same favicon MMH3 hash with pagination - GETGet Favicon Stats
/api/v1/favicon/statsGet statistics about favicon hashes in the database (recomputed hourly; computed_at says when). - GETGet Favicon Endpoint
/api/v1/favicon/:scan_idGet the favicon of a scan as a PNG. The served bytes are a re-encoded copy with metadata added, so their hash never matches the favicon search. Use the…
search
- GETSearch By Favicon Hash
/api/v1/search/favicon/:hash_valueSearch for scans by favicon hash (MMH3 or MD5) with pagination Returns scan IDs that match the given favicon hash Only returns public scans - GETSearch Scans
/api/v1/search?q=stringSearch scans by URL, domain, title, or all fields using optimized queries with pagination. Only returns public scans. - POSTSearch Similar Screenshots
/api/v1/screenshot/searchSearch for visually similar screenshots using perceptual hashing. Returns public scans whose screenshot hash is within max_distance bits of the one given,… - GETSearch By Screenshot Hash
/api/v1/search/screenshot/:hash_type/:hash_valueSearch for scans by screenshot hash with pagination Supports exact match and similarity search for perceptual hashes Returns scan IDs that match the given… - GETSearch By Fuzzy Hash
/api/v1/search/fuzzy/:hash_type?hash_value=stringSearch for scans by fuzzy hash (TLSH, ssdeep, or sdhash). Only returns public scans. - GETSearch By Ip
/api/v1/search/ip/:ip_addressSearch for scans containing a specific IP address. Only returns public scans. - GETGet Ip Stats
/api/v1/search/ip/:ip_address/statsGet detailed statistics and enrichment data for an IP address - GETSearch By Asn
/api/v1/search/asn/:asn_numberSearch for scans by AS number - uses indexed ASN columns for fast lookup with pagination - GETSearch Similar Scans
/api/v1/search/similar?scan_id=stringFind scans similar to a given scan using multiple hash methods with pagination. Combines results from screenshot, favicon, and fuzzy hash matching. Only… - GETSearch Analyzer High Risk Scans
/api/v1/analyzers/search/high-riskSearch for scans with high risk scores from security analyzer. min_risk_score is on the rule engine's 0-100 scale. The AI equivalent,… - GETSearch By Classification
/api/v1/ai/search/classification?classification=stringSearch scans by AI classification. - GETSearch Ai High Risk Scans
/api/v1/ai/search/high-riskSearch for high-risk scans with configurable thresholds. Scale caveat: min_risk_score here is on the AI engine's 0-10 scale, while the rule-engine endpoint… - GETSemantic Search
/api/v1/search/semantic?query=stringSearch for websites using natural language descriptions, matched against screenshots. Examples: "login page", "e-commerce checkout", "news website", "social… - GETVisual Similar Scans
/api/v1/similar/visual/:scan_idFind public scans whose screenshot looks like this scan's. 404 when the scan does not exist, is not public, or has no image embedding yet. The base scan is…
clipboard
- GETGet Clipboard Statistics
/api/v1/clipboard/statsGet clipboard monitoring statistics - GETGet Clipboard Events
/api/v1/clipboard/:scan_idGet clipboard events captured during a scan - GETGet Pastejacking Detections
/api/v1/pastejacking/:scan_idGet pastejacking detections for a scan - GETSearch Suspicious Clipboard
/api/v1/search/clipboard/suspiciousSearch for suspicious clipboard activity patterns
ocr
- GETSearch Ocr Text
/api/v1/search/ocr?q=stringSearch through OCR-extracted text from screenshots - GETSearch Ocr Pattern
/api/v1/search/ocr/pattern?pattern=stringSearch for specific patterns in OCR text (e.g., 'Windows+R', 'Ctrl+V') - GETGet Ocr Statistics
/api/v1/ocr/statsGet OCR processing statistics - GETGet Ocr Text
/api/v1/ocr/:scan_idGet OCR text extracted from a scan's screenshot
Technologies
- GETSearch technologies
/api/v1/technologies/searchSearch for technologies by name or category with full-text search support. Results are paginated and sorted by occurrence count. - GETGet Popular Technologies
/api/v1/technologies/popularGet most popular technologies from recent scans with pagination - GETGet Technology Combinations
/api/v1/technologies/combinations/:tech_nameFind technologies commonly used together with a specific technology, on public scans, with pagination. percentage is the share of the public scans with the… - GETGet Technology Stats
/api/v1/technologies/statsGet aggregated technology statistics (recomputed hourly; computed_at says when). - GETGet Scan Technologies
/api/v1/technologies/by-scan/:scan_idGet all technologies detected in a specific scan - GETGet Bot Protection
/api/v1/technologies/bot-protection/:scan_idGet bot protection technologies detected in a specific scan
domain
- GETGet Domain Scan Statistics
/api/v1/domain/stats/:domainGet scan statistics for a specific domain - GETGet Domain Scan History
/api/v1/domain/history/:domainGet scan history for a specific domain with pagination - GETGet Domain Scans
/api/v1/domains/:domain/scansPublic scans of a domain and its subdomains, matched on the scanned HOST. A scan matches when the domain is the entry host, the final host after redirects, or… - GETGet Domain Hosts
/api/v1/hosts/:domainEvery host seen for a domain, grouped by how we learned about it. Sources, strongest evidence first: observed the browser resolved and requested it scripts a…
pcap
- GETGet Pcap File
/api/v1/pcap/:scan_idDownload decrypted packet capture file for a scan. Returns compressed decrypted PCAP file with HTTP/HTTPS traffic in plaintext. - GETGet Pcap Metadata
/api/v1/pcap/:scan_id/metadataGet metadata about packet capture without downloading the file
certificates
- GETGet Ct Certificates
/api/v1/ct/:domainGet Certificate Transparency certificates for a domain Returns certificates with hash, timestamp, and CT log source - GETFind Similar Ct Domains
/api/v1/ct/similar/:domainFind similar domains in Certificate Transparency logs Searches for: Wildcard subdomains Domains containing the base domain Fuzzy matches for potential… - GETGet Ct Dns Records
/api/v1/ct/dns/:domainDNS observations for a domain and, by default, its subdomains. Returns domain, dns_records[] (domain / ip / record_type / timestamp / ttl / root_domain),… - GETFind Ct Domains On Ip
/api/v1/ct/ip/:ipFind all domains observed resolving to the same IP address. Returns ip, domains[{domain, record_count}] and total, ordered by how many DNS records back each… - GETFind Ct Root Domains On Ip
/api/v1/ct/ip/:ip/domainsRegistrable domains that resolved to an IP address when their TLS certificates were issued, grouped by registrable domain, alphabetical, cursor-paginated.… - GETGet Ct Certificate Timeline
/api/v1/ct/timeline/:domainGet certificate issuance timeline for a domain Shows when certificates were issued over time
reports
- POSTSubmit Scan Report
/api/v1/reportSubmit a report about a scanned URL Rate Limits: Maximum {REPORT_RATE_LIMIT_PER_IP} reports per IP per hour Maximum {REPORT_RATE_LIMIT_PER_SCAN} reports per… - GETGet Scan Report Counts
/api/v1/reports/:scan_id/countsGet vote counts for a specific scan (public endpoint, cached for 60 seconds)
js-fingerprinter2
- GETGet Js Fingerprinter2 Stats
/api/v1/js-fingerprinter2/statsGet aggregate statistics for obfuscation detection across all scans. Returns: Summary statistics including total scans analyzed, risk distribution, common… - GETSearch Js Obfuscation
/api/v1/js-fingerprinter2/search/js-obfuscationDeprecated. Search for scans with JavaScript obfuscation patterns. NOTE: This endpoint has been moved to /api/v1/search/js-obfuscation for consistency. Please… - GETGet Js Fingerprinter2 Per Script
/api/v1/js-fingerprinter2/:scan_id/scriptsGet per-script behavioral fingerprint data from js_fingerprinter2. Aggregates detailed_events by script URL to provide per-script summaries of eval calls,… - GETGet Js Fingerprinter2 Results
/api/v1/js-fingerprinter2/:scan_idGet JavaScript obfuscation detection results for a specific scan. Returns: Obfuscation analysis results including risk level, eval calls, and high-risk events…
ids
- GETGet Ids Alerts
/api/v1/ids/alerts/:scan_idGet network intrusion detection alerts for a specific scan
analyzers
- GETGet Analyzer Results
/api/v1/analyzers/:scan_idGet analyzer results for a specific scan - GETGet Analyzer Statistics
/api/v1/analyzers/stats/overviewGet overall analyzer statistics
cpe
- GETGet Cpe Stats
/api/v1/cpe/statsGet statistics about CPE detections from public scans only (recomputed hourly; computed_at says when). - GETGet Scan Cpes
/api/v1/cpe/:scan_idGet CPE identifiers extracted from a specific scan. - GETSearch Cpe
/api/v1/cpe/search/:cpe_patternSearch for scans containing specific CPE patterns or technology names with pagination. Matches both full CPE strings and plain technology names (e.g. 'nginx',…
safe-browsing
- GETGet Safe Browsing Stats
/api/v1/safe-browsing/statsGet statistics about Google Safe Browsing detections. - GETGet Safe Browsing Threats
/api/v1/safe-browsing/:scan_idGet Google Safe Browsing threats for a specific scan.
ai
- GETGet Ai Stats
/api/v1/ai/statsGet statistics about AI analysis results. Recomputed in the background at most every 15 minutes; as_of is when these numbers were computed (UTC). - GETGet Ai Analysis
/api/v1/ai/:scan_idGet AI-powered scam analysis results for a specific scan. - GETSearch By Scam Type
/api/v1/ai/search/scam-type?scam_type=stringSearch scans by detected scam type.
scan-summary
- GETGet Scan Summary
/api/v1/scan/:scan_id/summaryGet condensed scan summary for integrations
screenshot
- GETFind Duplicate Screenshots
/api/v1/screenshot/duplicatesFind groups of similar screenshots (potential duplicates) with pagination. Only exact matches (max_distance=0) are grouped: comparing every screenshot with… - GETGet Screenshot Stats
/api/v1/screenshot/statsGet statistics about screenshot hashes in the database - GETGet Screenshot
/api/v1/screenshot/:scan_idGet scan screenshot with optional resizing and format conversion - HEADGet Screenshot
/api/v1/screenshot/:scan_idGet scan screenshot with optional resizing and format conversion
jarm
- GETGet Jarm Signatures
/api/v1/jarm/scan/:scan_idGet all JARM signatures and analysis attempts for a specific scan. Returns: JARM TLS fingerprints for successful analyses Failure information for hosts where… - GETGet Jarm Stats
/api/v1/jarm/statsGet statistics about JARM signatures in the database. Returns counts of unique signatures, scans, hosts, and the most common signatures. Recomputed hourly;… - GETSearch By Jarm
/api/v1/search/jarm/:jarm_signatureSearch for scans by JARM TLS fingerprint with pagination. JARM fingerprints are 62-character hashes that identify TLS server configurations. This can help…
rpki
- GETGet Rpki Validation
/api/v1/rpki/:scan_idGet RPKI validation results for a scan. Returns validation status (valid/invalid/not-found) for each server IP address, with ASN, covering prefix, and risk…
dns
- GETDns For Scan
/api/v1/dns/scan/:scan_idThe DNS answers recorded for one scan, when it ran: the scanned hostnames (page), the registrable domain's mail servers, nameservers, TXT, SOA and CAA records… - GETDns History
/api/v1/dns/history/:nameEvery DNS answer a name gave, newest first: when public pages using it were scanned, and the addresses it resolved to when TLS certificates for it were… - GETDns Reverse Ip
/api/v1/dns/reverse/ip/:addressNames that resolved to an address or into a network (A/AAAA) during public scans, and the reverse-DNS (PTR) names of its addresses. Networks up to /16 (IPv4)… - GETDns Reverse Value
/api/v1/dns/reverse/:kind/:valueNames whose DNS pointed at a host or carried a token during public scans: kind is mx, ns, cname, ptr, spf_include, soa (primary nameserver or contact mailbox)…
malware
- GETGet Recent Threats
/api/v1/malware/threats/recentGet recently detected threats across all scans. Returns recent malware detections sorted by time, useful for threat monitoring and security intelligence. - GETGet Malware Statistics
/api/v1/malware/statsGet overall malware scanning statistics. Returns aggregated statistics about antivirus scans including total resources scanned, threats detected, and trends. - GETGet Malware Scan Results
/api/v1/malware/:scan_idGet malware scan results for a specific scan. Returns all antivirus malware detections including threat names, content types, and file hashes.
Hunting rules
- GETCommunity hunting rules
/api/v1/hunting-rules/communityActive community hunting rules, newest first. public_matches_30d counts distinct public scans matched in the last 30 days. - GETCommunity hunting rules that matched a scan
/api/v1/hunting-rules/community/scan/:scan_idActive community hunting rules that matched this scan (page or scripts). Supporting evidence only: they are written by users, checked automatically and not… - GETA community hunting rule
/api/v1/hunting-rules/community/:rule_idOne community hunting rule and its most recent matches on public scans. The rule's text (rule) is returned only to a signed-in staff account. - GETHunting-rule statistics
/api/v1/hunting-rules/statsOverall hunting-rule detection statistics. Returns aggregated statistics about hunting-rule matches, including: Total detections and unique patterns Severity… - GETRecent threats found by hunting rules
/api/v1/hunting-rules/threats/recentThreats recently detected by hunting rules across all scans. Returns recent malware pattern matches sorted by detection time, useful for threat monitoring and… - GETHunting-rule matches of a scan
/api/v1/hunting-rules/scan/:scan_idHunting-rule matches for a specific scan. Returns the hunting rules that matched the page, its frames or its scripts, including rule metadata, severity,… - GETHunting-rule matches of a scan (legacy path)
/api/v1/hunting-rules/:scan_idHunting-rule matches for a specific scan (legacy endpoint). This is an alias for /scan/{scan_id} for backward compatibility. - POSTTest a hunting rule on public scripts
/api/v1/hunting-rules/testRuns a hunting rule in isolation: static checks, compilation with every warning an error, a benchmark on a fixed set of public scripts (speed and breadth),… - PUTFollow Rule
/api/v1/hunting-rules/community/:rule_id/followFollow a community hunting rule: get an email when it matches new scans (in the same hourly digest as the hunts you follow). Requires a Bearer token and a… - DELETEUnfollow Rule
/api/v1/hunting-rules/community/:rule_id/followStop following a community hunting rule. Requires a Bearer token. Idempotent.
tracking
- GETGet Top Trackers
/api/v1/tracking-keys/stats/topGet top tracking keys by usage - GETGet Scan Tracking Keys
/api/v1/tracking-keys/by-scan/:scan_idGet all tracking keys for a specific scan with usage statistics - GETSearch By Tracking Key
/api/v1/tracking-keys/:tracker_type/:keyFind all scans using a specific tracking key
registrar
- GETSearch By Registrar
/api/v1/registrar/search/:registrar_nameSearch for scans by registrar name (case-insensitive substring match).
segments
- GETGet Scan Segments Security
/api/v1/segments/by-scan/:scan_id/securitySecurity analysis for every segment of one scan, in a single request. Prefer this over calling /segments/{id}/security once per segment: it returns the same… - GETGet Segment Security
/api/v1/segments/:segment_id/securityGet security analysis for a specific JavaScript segment. Returns malware pattern matches, risk assessment, and threat intelligence for the given segment ID.… - GETGet Segment
/api/v1/segments/:segment_idGet basic information about a JavaScript segment. Args: segment_id: The unique segment identifier Returns: Segment metadata including script URL, function…
smql
- GETSmql Search
/api/v1/search/smql?q=stringSearch scans using the ScanMalware Query Language (SMQL). Syntax examples: Simple text: paypal login Filters: domain:paypal.com, country:RU,… - POSTSmql Counts
/api/v1/search/smql/countsThe number of public scans matching each of several SMQL queries, in one request. The same count GET /search/smql?count_only=true gives for one query:… - POSTSmql Hunt Check
/api/v1/search/smql/hunt-checkWhich of these values a hunt searches for: the queries, among those sent, that are a single field:value match a hunt uses (its query's plain matches, its… - GETSmql Facets
/api/v1/search/smql/facets?q=stringWhat the scans matching an SMQL query have in common: the most frequent hosting networks, countries, domains, registrars, certificate issuers, technologies,… - GETSmql Domain Search
/api/v1/search/smql/domains?q=stringSearch DOMAINS rather than scans: lists every matching domain, including domains ScanMalware has never scanned, each annotated with its newest public scan if… - GETSmql Stats
/api/v1/search/smql/statsReturn estimated total public scan count (from pg_class, essentially free). - GETSmql Filters
/api/v1/search/smql/filtersReturn all available SMQL filters grouped by category.
account
- GETGet Account Preferences
/api/v1/account/preferencesThe account's time zone: the zone times are shown in on the website and in the emails we send you ('auto' = your device's own zone). Every time in an API… - PUTPut Account Preferences
/api/v1/account/preferencesSet the time zone ('auto' or a zone name such as 'Europe/Stockholm') and/or the zone your browser reports; a field left out stays as it is. Answers 400 for a… - GETAccount Overview
/api/v1/account/overviewHeadline stats for the account dashboard. - GETAccount Scans
/api/v1/account/scansThe authenticated user's submitted scans, newest first. - GETAccount Logins
/api/v1/account/loginsSign-ins and failed sign-in attempts of the authenticated user, newest first and paged (kept for 180 days): the time, the IP address with its country and… - GETAccount Activity
/api/v1/account/activityRecent changes to how the account signs in, newest first (kept for 30 days): sign-in methods added, changed or removed, email and profile changes, password… - GETAccount Security
/api/v1/account/securitySign-in methods on the account: password, passkeys and two-factor authentication, each with the action that sets it up or changes it and whether it can be… - GETAccount Sessions
/api/v1/account/sessionsWhere the account is signed in: one entry per session, the current one flagged. - DELETESign Out Other Sessions
/api/v1/account/sessions/othersSign out every session of the account except the one making this request. - DELETESign Out Session
/api/v1/account/sessions/:session_idSign out one session of the account. - GETAccount Linked Accounts
/api/v1/account/linked-accountsThe sign-in providers on offer (Google, GitHub, Microsoft) and which of them are linked to the account. A link is added from the account page, which sends you… - DELETEUnlink Account
/api/v1/account/linked-accounts/:aliasRemove the link to one sign-in provider. A link that is the account's only way to sign in cannot be removed. - GETList Api Keys
/api/v1/account/api-keysList the authenticated user's non-revoked API keys (expired ones are flagged so users can review and clean them up). - POSTCreate Api Key
/api/v1/account/api-keysCreate a new personal access token. The full token is returned ONCE in this response; only the SHA-256 hash of its secret part is stored. A notice is emailed… - POSTRevoke All Api Keys
/api/v1/account/api-keys/revoke-allEmergency revocation of ALL of the authenticated user's API keys. - POSTRemove Expired Api Keys
/api/v1/account/api-keys/remove-expiredRemove the authenticated user's expired API keys from the list (they already do not work). - GETApi Key Audit Trail
/api/v1/account/api-keys/auditThe authenticated user's API key audit trail (newest first). - DELETERevoke Api Key
/api/v1/account/api-keys/:key_idRevoke (soft-delete) one of the authenticated user's API keys. - PATCHRename Api Key
/api/v1/account/api-keys/:key_idRename one of the authenticated user's API keys. The token does not change. - POSTRotate Api Key
/api/v1/account/api-keys/:key_id/rotateGive one of the authenticated user's API keys a new token and a new expiry date; the name and permissions stay. The old token stops working at once, and the… - GETEmail Settings
/api/v1/account/emailsWhich emails this account gets. Requires a Bearer token. onboarding is null for an account that is not enrolled (created before the getting-started emails… - PUTSet Onboarding
/api/v1/account/emails/onboardingStop, or start again, the getting-started emails for the signed-in account. 404 if it is not enrolled. - GETUnsubscribe Info
/api/v1/account/emails/unsubscribe/:tokenWhether this getting-started email link is valid and already unsubscribed. Changes nothing. - POSTUnsubscribe
/api/v1/account/emails/unsubscribe/:tokenStop the getting-started emails for this account. Idempotent; also the one-click target (RFC 8058). - GETExample Result
/api/v1/onboarding/example-resultA recent public result a newcomer can open to see what a scan shows: {"scan_id": "<uuid>"} or {"scan_id": null}. Picked by properties (see pick_example_scan),…
web-features
- GETGet Scan Web Features
/api/v1/scans/:scan_id/web-featuresBrowser features and web APIs the page used while it loaded, as counted by the browser. recorded: false means no features were recorded for this scan (scans… - GETGet Similar By Web Features
/api/v1/scans/:scan_id/web-features/similarOther sites whose pages used nearly the same set of browser features as this scan's page. Similarity is the share of features in common: those both pages…
scans
- GETGet Scan Pivot Values
/api/v1/scans/:scan_id/pivot-valuesValues of a scan that can be searched, beyond those in the main result. resources: SHA-256 of each response body the page loaded (HTML, scripts, stylesheets,…
graph
- POSTGraph Scans
/api/v1/graph/scansUp to 20 public scans, each with a summary and the values that link it to other scans. Each entry of scans carries scan_id, url and final_url (scheme, host…
webassembly
- GETGet Scan Wasm
/api/v1/scans/:scan_id/wasmWebAssembly modules the scanned page used: carried in its scripts, downloaded, or built at run time. Each module has its size, how it reached the page (how),… - GETGet Wasm Module
/api/v1/wasm/:sha256One WebAssembly module: its structure (sections, imports, exports, data segments and their entropy), what the analysis found (labels, names, hosts it names,… - GETDownload Wasm Module
/api/v1/wasm/:sha256/downloadThe module's bytes, as the page had them (application/octet-stream, saved as <sha256>.wasm). WebAssembly does nothing on its own: it runs only when a script… - GETGet Wasm Code
/api/v1/wasm/:sha256/codeThe module's decompiled code, one entry per function (C-like pseudocode) or, for a .NET assembly, per type (C#): name, size, control-flow blocks and… - GETGet Wasm Code Unit
/api/v1/wasm/:sha256/code/:iOne function's or type's decompiled code, with its facts (as in the code list), its control-flow graph size, and for a .NET type the JavaScript and native…
files
- GETGet File
/api/v1/files/:sha256One file that a public scan delivered (a download, a direct link to the file, a page's download link, a command put on the clipboard) or that was found inside…
jsfingerprints
- GETWhat the deobfuscator found in this script
/api/v1/jsfingerprints/:fingerprint_id/deobfuscationHow the script was obfuscated (tool, techniques, level), what decoding and unpacking did, and what became visible only after decoding: URLs, hosts, wallet… - GETWhat the deobfuscator found in each script of a scan
/api/v1/scans/:scan_id/deobfuscationEvery script the scan captured, once per distinct content: whether and how it was obfuscated (tool, level), whether decoding or unpacking worked, and how much… - GETThe script after decoding
/api/v1/jsfingerprints/:fingerprint_id/decoded-sourceOne output of the deobfuscator for this script: readable-0 (the decoded script cleaned up: fully decoded string-array code removed, obj['name'] written… - GETList Fingerprints For Scan
/api/v1/scans/:scan_id/jsfingerprintsGet all JavaScript fingerprints for a specific scan. A scan with many scripts gives a large answer (~4.6 KB a script): page it with limit and offset, and pass… - GETGet Single Fingerprint
/api/v1/jsfingerprints/:fingerprint_idGet detailed information about a single JavaScript fingerprint. - GETFind Similar Javascript
/api/v1/jsfingerprints/:fingerprint_id/similarFind JavaScript files similar to the given fingerprint using ML vector similarity. Uses cosine similarity on the 192-dimensional composite vector (AST +… - GETSearch By Sha256
/api/v1/jsfingerprints/search/sha256/:hash_valueSearch JavaScript fingerprints by exact SHA-256 hash. Only searches public scans. - GETSearch By Normalized
/api/v1/jsfingerprints/search/normalized/:hash_valueSearch JavaScript fingerprints by normalized SHA-256 hash. Normalized hash ignores whitespace and formatting differences. Only searches public scans. - GETSearch By Md5
/api/v1/jsfingerprints/search/md5/:hash_valueSearch JavaScript fingerprints by MD5 hash. Only searches public scans. - GETSearch By Sha1
/api/v1/jsfingerprints/search/sha1/:hash_valueSearch JavaScript fingerprints by SHA-1 hash. Only searches public scans. - GETSearch By Library
/api/v1/jsfingerprints/search/library/:librarySearch JavaScript fingerprints by library name. Only searches public scans. - GETSearch By Library Version
/api/v1/jsfingerprints/search/library/:library/version/:versionSearch JavaScript fingerprints by library name and specific version. Only searches public scans. - GETSearch By Bundler
/api/v1/jsfingerprints/search/bundler/:bundlerSearch JavaScript fingerprints by bundler type (webpack, rollup, vite, etc.). Only searches public scans. - GETSearch By Fuzzy Hash
/api/v1/jsfingerprints/search/fuzzy/:fuzzy_hashSearch JavaScript fingerprints by SSDEEP fuzzy hash. Fuzzy hashing allows finding similar code even with modifications. Only searches public scans. - GETGet Bundle Statistics
/api/v1/jsfingerprints/statistics/bundlesGet statistics about bundled JavaScript across all scans. - GETGet Library Statistics
/api/v1/jsfingerprints/statistics/librariesGet statistics about detected JavaScript libraries. The full answer is large (about 3 MB with the defaults: ~18,000 libraries, some with over 1,000 version… - GETGet Hash Prevalence
/api/v1/jsfingerprints/hash-prevalence/:scan_idGet prevalence counts for script hashes in a scan. Returns how many other scans contain scripts with matching hashes. This helps identify commonly used… - GETGet Similarity Counts
/api/v1/jsfingerprints/:fingerprint_id/similarity-countsGet count of similar scripts for EACH ML algorithm separately. Returns similarity counts for: CodeBERT (768-dim semantic code embedding) GraphCodeBERT… - GETGet script source code
/api/v1/jsfingerprints/:fingerprint_id/sourceRetrieve the original JavaScript source code for a fingerprint from object storage - GETShell commands staged in the script
/api/v1/jsfingerprints/:fingerprint_id/command-literalsStatic check for a Windows or macOS shell command held as a string literal in this script (the ClickFix pattern), with any delivery-stealth traits.
scripts
- GETGet Scan Libraries
/api/v1/scans/:scan_id/librariesJavaScript libraries and packages identified on the scanned page, with their versions and the scripts they were found in. status is ready, pending…
Module Monitoring
- GETHealth Check
/api/v1/modules/pingBasic health check endpoint - No authentication required Returns simple status for uptime monitoring
jsfingerprint-search
- GETSearch By Sha256
/api/v1/jsfingerprint/hash/sha256/:hashFind exact JavaScript content matches by SHA-256 hash. Use Case: Malware detection, code reuse tracking, supply chain security Performance: < 100ms (indexed… - GETSearch By Md5
/api/v1/jsfingerprint/hash/md5/:hashFind exact JavaScript content matches by MD5 hash. Use Case: Legacy hash lookups, malware detection, code reuse tracking Performance: < 100ms (indexed lookup) - GETSearch By Sha1
/api/v1/jsfingerprint/hash/sha1/:hashFind exact JavaScript content matches by SHA-1 hash. Use Case: Legacy hash lookups, malware detection, code reuse tracking Performance: < 100ms (indexed lookup) - GETSearch By Normalized Hash
/api/v1/jsfingerprint/hash/normalized/:hashFind whitespace-independent code matches by normalized hash. Use Case: Detect minified/formatted variants of same code Performance: < 100ms (indexed lookup) - GETSearch By Fuzzy Hash
/api/v1/jsfingerprint/hash/fuzzy/:fuzzy_hashFind similar code using SSDEEP fuzzy hashing. Use Case: Detect obfuscated/modified variants of malware Performance: 500ms-2s (requires fuzzy comparison) Note:… - GETSearch By Library
/api/v1/jsfingerprint/library/:library_nameFind all scripts using a specific JavaScript library. Use Case: Vulnerable library tracking, supply chain security Performance: 500ms-1s - GETSearch By Library Version
/api/v1/jsfingerprint/library/:library/version/:versionFind exact library+version combinations. Use Case: CVE tracking - find all scans using vulnerable version Performance: < 500ms - GETGet Library Inventory
/api/v1/jsfingerprint/library-inventoryGet library version inventory aggregated across all scans. Returns a catalog of detected JavaScript libraries and their versions, showing usage statistics and… - GETSearch By Cdn
/api/v1/jsfingerprint/cdn/:cdn_typeFind all scripts hosted on specific CDN. Use Case: Infrastructure analysis, CDN compromise detection Performance: < 1s - GETSearch By Server
/api/v1/jsfingerprint/server/:server_typeFind scripts by HTTP server type. Use Case: Infrastructure fingerprinting, attack surface analysis total_scripts is capped at 1,000; total_is_lower_bound is… - GETSearch Obfuscated
/api/v1/jsfingerprint/obfuscatedFind obfuscated JavaScript, as rated by the deobfuscator (the level shown on a script's Deobfuscation tab). Use Case: Malware hunting, suspicious code detection - GETSearch By Patterns
/api/v1/jsfingerprint/patternsAdvanced pattern-based malware hunting. Use Case: Threat intelligence, malware research Performance: 2-5s (complex JSONB queries) Note: Pattern detection… - GETSearch By Bundler
/api/v1/jsfingerprint/bundler/:bundler_typeFind scripts by bundler type. Use Case: Build tool analysis, supply chain security Performance: < 1s - POSTFind Similar By Hash
/api/v1/jsfingerprint/similar-by-hashFind similar scripts by providing content hash (not fingerprint ID). Use Case: Public malware detection without requiring existing fingerprint Performance:…
js-fingerprinter2-search
- GETSearch Similar Fingerprints
/api/v1/js-fingerprinter2/search/similar/:scan_idFind scans with similar behavioral fingerprints. Uses weighted component comparison: Call Pattern (35%): Execution behavior vector Characteristics (25%): Eval… - GETSearch By Composite Hash
/api/v1/js-fingerprinter2/search/composite-hash/:composite_hashFind all scans with an exact composite-hash match. The composite hash is a SHA-256 digest of all behavioral data (call patterns, API usage, execution… - GETSearch By Stable Signature
/api/v1/js-fingerprinter2/search/stable-signature/:signature_hashFind all scans with matching stable behavioral signature. The stable signature buckets API usage into categories (none/low/medium/high/very_high) and… - GETSearch By Behavior Vector
/api/v1/js-fingerprinter2/search/behavior-vector/similar/:scan_idFind scans with similar behavior vectors using L1 (Manhattan) distance. The behavior vector is a 32-byte feature vector encoding API usage intensity, code… - GETSearch By Code Hash
/api/v1/js-fingerprinter2/search/code-hash/:code_hashFind all scans containing scripts with exact code hash match. The code hash is a SHA-256 hash of the script's source code. This allows finding identical… - GETSearch By Signature
/api/v1/js-fingerprinter2/search/signature/:signatureFind scans with matching behavior signature. Signature format: eval:X|Function:Y|api:count|complexity Example: eval:15|Function:3|setTimeout:45|medium Use… - GETDetect Malware Families
/api/v1/js-fingerprinter2/search/malware-familiesDISABLED (2026-05-19) — behavioral malware-family clustering. This endpoint grouped scans by the behavioral compositeHash. An evaluation found that hash to be… - GETGet Fingerprint Coverage
/api/v1/js-fingerprinter2/search/fingerprint-coverageGet statistics on behavioral fingerprint coverage. Shows how many scans have fingerprints enabled vs disabled. Recomputed at most hourly; computed_at says when. - GETHealth Check
/api/v1/js-fingerprinter2/search/healthHealth check for JS-Fingerprinter2 search API
hunts
- GETMy Follows
/api/v1/hunts/followsThe hunts you follow. Requires a Bearer token. New matches are emailed to email, at most once an hour. - DELETEUnfollow All
/api/v1/hunts/followsStop following every hunt and hunting rule. Requires a Bearer token. Idempotent. - GETFollow Suggestions
/api/v1/hunts/follows/suggestionsHunts worth following: those that matched the most sites in public scans over the last 7 days, critical ones first. No sign-in needed. Counted by when the… - PUTFollow Hunt
/api/v1/hunts/:hunt_id/followFollow a hunt: get an email when it matches new scans. Requires a Bearer token and a verified email address. Idempotent. - DELETEUnfollow Hunt
/api/v1/hunts/:hunt_id/followStop following a hunt. Requires a Bearer token. Idempotent. - GETHunts List
/api/v1/hunts - POSTHunts Create
/api/v1/hunts - GETHunts Recent Sightings
/api/v1/hunts/sightings/recentThe newest public scans that matched a hunt, across all hunts, newest scan first. One row per scan and hunt; a scan that matches three hunts gives three rows… - GETHunts Feed
/api/v1/hunts/feed.atomAtom feed of the newest public scans that matched any hunt (last three days), one entry per scan listing the hunts it matched. - GETHunt Feed
/api/v1/hunts/:hunt_id/feed.atomAtom feed of one hunt's newest public sightings, one entry per scan. - GETHunts Detail
/api/v1/hunts/:hunt_id
js-fingerprinting3
- GETPage Hunts For Scan
/api/v1/js-fingerprinting3/scan/:scan_id/page-huntsHunts that matched the scanned page itself rather than one of its scripts. The same page_hunts list that /scan/{scan_id} returns, without the per-script… - GETFingerprints For Scan
/api/v1/js-fingerprinting3/scan/:scan_idAll structural fingerprints recorded for one scan. Each row is enriched with corpus-wide prevalence counts (content_seen, canonical_seen) and, where one is… - GETSearch Canonical
/api/v1/js-fingerprinting3/canonical/:canonical_ast_hashEvery script whose canonical AST hash matches — the same code structure even under identifier renaming (the obfuscation-resistant identity). - GETSearch Content
/api/v1/js-fingerprinting3/content/:content_sha256Every scan where a byte-identical script appeared. - GETSearch Similar
/api/v1/js-fingerprinting3/similar/:row_idScripts that are structurally similar to this one, nearest-neighbour ranked. Each match carries code_overlap, the estimated share of code it has in common… - GETList Kits
/api/v1/js-fingerprinting3/huntsAll registered kits in the roster + a running sighting count per kit. Counts cover public scans. last_hit_at is when the newest matching page was scanned.… - POSTAdd Kit
/api/v1/js-fingerprinting3/huntsRegister a new malicious-kit build (analyst/admin only). Anchors may be given directly (content_sha256 / canonical_ast_hash / tlsh / yara_rule_name) or taken… - GETKit Detail
/api/v1/js-fingerprinting3/hunt/:hunt_idKit metadata and its sightings on public scans, newest scan first. total_sightings counts them all; sightings_shown is how many this response lists (at most… - GETStats
/api/v1/js-fingerprinting3/statsCoverage statistics for js-fingerprinting3.
brands
- GETList Brands
/api/v1/brandsThe brand catalog with per-brand published counts. Paginated and filterable. The unparameterised call used to return all 651 rows (~156 KB) on every request,… - GETList Sectors
/api/v1/brands/sectorsSector facet counts (for the gallery filter chips). - GETBrand Detail
/api/v1/brands/:slug_or_idOne brand + the published hosts caught impersonating it. One entry per HOST (most recently seen first), carrying that host's repeat count and the newest… - GETBrand Timeline
/api/v1/brands/:slug_or_id/timelinePublished hosts first seen per day and sightings per day, oldest first, every day in the window present. Exists so this can be consumed as a feed rather than… - GETBrand Export
/api/v1/brands/:slug_or_id/exportThe published host rows as CSV or JSON, for offline analysis.
TLS Certificates
- GETGet Tls Certificate
/api/v1/tls/:scan_idGet TLS/SSL certificate analysis for a scan Returns comprehensive certificate details including: Subject and issuer information Validity dates and expiration… - GETDownload Certificate
/api/v1/tls/:scan_id/certificate/downloadDownload the TLS/SSL certificate in PEM format Returns the certificate as a downloadable .pem file that can be: Imported into browsers/keychains Inspected… - GETGet Certificate Asn1
/api/v1/tls/:scan_id/asn1Get ASN.1 parsed certificate structure Returns the raw ASN.1 structure of the certificate parsed using asn1crypto, providing detailed information about all…
JavaScript Segments
- GETGet Segments By Scan
/api/v1/js-segments/scan/:scan_idGet all code segments for a scan. Returns detailed information about all extracted functions, classes, and code blocks. Optionally filter by script_url to get… - GETSearch By Code Hash
/api/v1/js-segments/search/hash/:code_hashFind all segments with matching exact code hash. Useful for finding identical code segments across different scans. - GETSearch By Normalized Hash
/api/v1/js-segments/search/normalized/:normalized_hashFind all segments with matching normalized code hash. Normalized hashes remove whitespace and comments, enabling fuzzy matching of functionally identical code… - GETSearch By Tlsh Similarity
/api/v1/js-segments/search/tlsh/:tlsh_hashFind code segments similar to the given TLSH hash. TLSH (Trend Micro Locality Sensitive Hash) enables fuzzy matching of code that has been: Minified or… - GETGet Unknown Segments
/api/v1/js-segments/:scan_id/unknownIdentify segments not matching known libraries. Returns code segments that aren't recognized as part of known JavaScript libraries. These are candidates for… - GETGet Suspicious Segments
/api/v1/js-segments/:scan_id/suspiciousGet high-risk segments that aren't known libraries. Returns segments with elevated risk scores that are unknown, indicating potential malicious code (eval… - POSTPerform Differential Analysis
/api/v1/js-segments/differentialCompare bundle segments against known library database. Analyzes all segments in a scan and identifies: Which segments match known libraries (jQuery, React,… - GETGet Differential Analysis
/api/v1/js-segments/:scan_id/differentialGET form of POST /differential, returning the identical result, so the analysis can be opened as a link. Its totals can differ from…
- GETRoot
/api/v1/API root endpoint - GETGet Recent Scans
/api/v1/recentGet recent public scans with pagination - only public scans are returned via API - GETGet Rss Feed
/api/v1/rssRSS feed of latest public scans (cached for 60 seconds) - GETGet Sitemap
/sitemap.xmlServe the pre-generated XML sitemap. - GETGet Sitemap Gz
/sitemap.xml.gzServe the gzip-compressed sitemap as a gzip file. - GETGet Robots Txt
/robots.txtServe robots.txt. - GETGet Og Metadata
/api/v1/og/:scan_idGet Open Graph metadata for a scan (lightweight endpoint for link previews) - GETGet Scan Progress Endpoint
/api/v1/result/:scan_id/progressGet current scan progress for frontend progress bar - GETGet Screenshot Preview
/api/v1/result/:scan_id/screenshot-previewScreenshot of a scan that is still being saved; 204 until the scanner has uploaded one. - GETGet Rdap Info
/api/v1/rdap/:scan_idGet RDAP/WHOIS domain registration information for a scan Returns domain age, registration date, and other RDAP data with proper security validation. Args:… - GETSearch By Nameserver
/api/v1/ns/:nameserverSearch for all registered domains using a specific nameserver. Combines a primary domain dataset (covering the TLDs listed in tld_coverage) with a… - GETGet Ioc Matches
/api/v1/ioc/:scan_idGet IoC (Indicators of Compromise) threat intelligence matches for a scan Returns all matched malicious indicators (IPs and domains) that were found in the… - POSTSubmit Scan
/api/v1/scanSubmit a URL for scanning with URL validation and optional CSRF protection. Supports flexible URL input formats: Full URLs: https://example.com,… - GETGet Load Time Distribution Stats
/api/v1/stats/load-time-distributionPublic corpus distribution of page-load times (the basis for the result-page "Very Fast/Fast/Medium/Slow" badge). - GETGet Scan Result
/api/v1/result/:scan_idGet scan result by ID. Pass compact=true to leave out the request logs (see the parameter). - GETHealth Check
/api/v1/healthLiveness check: returns ok while the API is serving requests. - GETHealth Dependencies
/api/v1/health/depsDependency health: HTTP 503 when a service the API depends on is unavailable. Answer from the status code; the body names each dependency as connected or…
API details
- Authentication
- A bearer token in the Authorization header
A bearer token in the Authorization header - Operations
- 246 operations on 236 pathsGET 217POST 16DELETE 7PUT 4HEAD 1PATCH 1
1 marked deprecated - Main resources
- account 25jsfingerprints 20jsfingerprint-search 14search 14hunts 11Hunting rules 10js-fingerprinter2-search 9js-fingerprinting3 9JavaScript Segments 8smql 7
- Response formats
application/json- Description format
- OpenAPI 3.1.0, API version
1.0.0 - Links
- OpenAPI document
- Listed from
- Scanmalware's published OpenAPI description
How to test the ScanMalware API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the ScanMalware API collection, without the publisher's secrets.
- Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Get Stats” (GET /api/v1/stats), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the ScanMalware API?
Scan URLs in a sandboxed browser and search past scans by domain, IP, ASN, JARM or favicon hash It is listed under Identity & security and has 246 endpoints.
Who publishes the ScanMalware API?
It is listed from ScanMalware.com's public API description (an OpenAPI document), not published by ScanMalware.com on Swastik Codes. Anyone who controls scanmalware.com can claim the profile by adding a DNS TXT record.
How do I authenticate with the ScanMalware API?
It accepts 2 methods: A bearer token in the Authorization header; A bearer token in the Authorization header.
How many endpoints does the ScanMalware API have?
246 operations on 236 paths (217 GET, 16 POST, 7 DELETE, 4 PUT, 1 HEAD, 1 PATCH). The largest groups are account, jsfingerprints, jsfingerprint-search, search.
Is forking the ScanMalware API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.