abuse.ch
Look up malware-distribution URLs, hosts and file payloads tracked by abuse.ch's URLhaus, pull recent-activity feeds, and report new malware URLs to the community blocklist.
Connectors
Choose the connector that matches your authentication method. The options below use the names shown in StackAI.
abuse.ch
Auth-Key
abuse.ch
Connect to abuse.ch to look up malware-distribution URLs, hosts and payloads tracked by URLhaus, and report new malware URLs to the community blocklist.
Set up in abuse.ch
Prepare the abuse.ch account or service that the workflow will access. Grant access to the required resources and operations.
Auth-Key: Your free abuse.ch Auth-Key. Register at auth.abuse.ch and generate a key from your profile; the same key authenticates URLhaus, ThreatFox, MalwareBazaar and YARAify, and has been required for API access since June 2025.
Set up in StackAI
Open Settings → Connections, add a connection, and select abuse.ch.
Enter the credentials and connection details in the fields below.
Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.
Connection fields
Auth-Key
Yes
Your free abuse.ch Auth-Key. Register at auth.abuse.ch and generate a key from your profile; the same key authenticates URLhaus, ThreatFox, MalwareBazaar and YARAify, and has been required for API access since June 2025. Provider instructions.
Verify the connection
Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.
If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.
Use an action
Add the required abuse.ch action to the workflow.
Select a connection when the action requests one.
Complete the required fields. Use the reference picker when a value comes from another workflow step.
Run the workflow and inspect the action’s output. Check the result before using it in a later step.
Actions
Look Up Malware URL
Check whether a URL is known to URLhaus as distributing malware, and see whether it is still live, what malware it served, and who reported it.
Inputs
URL
string
Yes
The full URL to check, including http:// or https://.
Outputs
Known to URLhaus
boolean
Whether URLhaus has a record for this URL.
URLhaus ID
string
URLhaus's own identifier for this URL entry.
Status
string
Whether the URL is currently serving the payload.
Threat type
string
What kind of threat the URL represents.
Host
string
The domain or IP serving the URL.
First reported
datetime
When the URL was first added to URLhaus.
Last seen online
datetime
The last time URLhaus saw the URL serving its payload.
Reported by
string
The URLhaus account that reported the URL.
Abuse report sent
boolean
Whether an abuse report was sent to the hosting provider.
Time to takedown (seconds)
integer
How long the URL stayed online before it was taken down.
Tags
string_array
Malware family and file-type tags on this URL.
Spamhaus DBL
string
How Spamhaus's domain blocklist classifies the host.
SURBL
string
How the SURBL blocklist classifies the host.
Payloads served
object_array
The malware files this URL has been seen delivering.
URLhaus page
string
Link to the human-readable URLhaus entry.
Look Up Malicious Host
See every malware URL URLhaus knows about on a domain or IP address, plus how the major blocklists classify it.
Inputs
Domain or IP address
string
Yes
The domain, hostname or IP address to check.
Outputs
Known to URLhaus
boolean
Whether URLhaus has any record for this host.
Host
string
The host as URLhaus recorded it.
First seen
datetime
When URLhaus first recorded a malware URL on this host.
Malware URL count
integer
How many malware URLs URLhaus has recorded on this host.
Spamhaus DBL
string
How Spamhaus's domain blocklist classifies the host.
SURBL
string
How the SURBL blocklist classifies the host.
Malware URLs
object_array
The malware URLs recorded on this host.
URLhaus page
string
Link to the human-readable URLhaus host page.
Look Up Malware Payload
Identify a file by its hash: what malware family it belongs to, when it was first seen, and which URLs have been distributing it.
Inputs
File hash (MD5 or SHA-256)
string
Yes
The MD5 or SHA-256 hash of the file you want to identify.
Outputs
Known to URLhaus
boolean
Whether URLhaus has a record for this hash.
MD5
string
The file's MD5 hash.
SHA-256
string
The file's SHA-256 hash.
File type
string
The kind of file, for example exe, elf or doc.
File size (bytes)
integer
The sample's size in bytes.
Malware family
string
The malware family this sample was attributed to.
First seen
datetime
When URLhaus first saw this sample.
Last seen
datetime
When URLhaus last saw this sample.
Distributing URL count
integer
How many URLs have been seen serving this sample.
VirusTotal detection rate
string
Share of VirusTotal engines that flagged the sample.
VirusTotal report
string
Link to the VirusTotal report for this sample.
Import hash
string
Import-table hash, used to cluster related Windows binaries.
ssdeep fuzzy hash
string
Fuzzy hash for finding near-identical files.
TLSH fuzzy hash
string
Alternative fuzzy hash for finding near-identical files.
Magika file type
string
File type as inferred by Google's Magika classifier.
Sample download link
string
URLhaus link to the raw sample, for handing to a malware sandbox.
Distributing URLs
object_array
The URLs seen serving this sample.
List Recent Malware URLs
Pull the newest malware URLs reported to URLhaus, for feeding a blocklist or triaging what is currently circulating.
Inputs
Maximum URLs
integer
No
How many of the newest URLs to return. Up to 1000.
Outputs
Malware URLs
object_array
The newest malware URLs reported to URLhaus.
URLs returned
integer
How many URLs came back.
List Recent Malware Payloads
Pull the newest malware samples URLhaus has seen, with their hashes and malware families.
Inputs
Maximum payloads
integer
No
How many of the newest samples to return. Up to 1000.
Outputs
Malware payloads
object_array
The newest malware samples URLhaus has seen.
Payloads returned
integer
How many samples came back.
List Malware URLs by Malware Tag
Find recent malware URLs carrying a specific tag, such as a malware family name or a file type.
Inputs
Tag
string
Yes
The URLhaus tag to search for, for example Emotet or mirai.
Maximum URLs
integer
No
How many URLs to return. Up to 1000.
Outputs
Any results
boolean
Whether URLhaus has any URL carrying this tag.
First seen
datetime
When URLhaus first saw this tag.
Last seen
datetime
When URLhaus last saw this tag.
Total URL count
integer
How many URLs URLhaus has recorded with this tag.
Malware URLs
object_array
The URLs carrying this tag.
List Malware URLs by Malware Family
Find the URLs and samples URLhaus attributes to a malware family, such as Emotet or AgentTesla.
Inputs
Malware family
string
Yes
The malware family to search for, for example Emotet or AgentTesla.
Maximum URLs
integer
No
How many URLs to return. Up to 1000.
Outputs
Any results
boolean
Whether URLhaus attributes anything to this family.
First seen
datetime
When URLhaus first attributed a sample to this family.
Last seen
datetime
When URLhaus last attributed a sample to this family.
Total URL count
integer
How many URLs URLhaus attributes to this family.
Total sample count
integer
How many distinct samples URLhaus attributes to this family.
Malware URLs
object_array
The URLs distributing this family, with their sample details.
Submit Malware URL
Report a URL that distributes malware to URLhaus, so the wider security community can block it. Published publicly and hard to undo.
Inputs
Malware URL
string
Yes
The full URL that serves malware. This is published publicly on URLhaus and cannot be withdrawn through the API.
Tags
string
No
Optional comma-separated labels for the submission, such as the malware family or file type.
Submit anonymously
boolean
No
Hide your abuse.ch account name on the public URLhaus entry. Off by default, so submissions are credited to your account. Default: false.
Outputs
Accepted
boolean
Whether URLhaus accepted the submission; null if unconfirmed.
Submission status
string
What URLhaus did with the submission.
URLhaus page
string
Link to the published URLhaus entry, when the provider returns one.
Triggers
A trigger starts a workflow when its configured event occurs. Configure the event and filters before enabling the trigger.
New Malware URL
Starts the workflow for each new malware URL reported to URLhaus, optionally narrowed to specific tags.
Setup only needs an abuse.ch connection. Optionally restrict to specific tags (comma-separated, e.g. Emotet,mirai); leave empty to fire on every new malware URL. The feed returns at most 1000 URLs per poll; higher volume between polls can cause missed URLs.
Configuration
Only these tags
string
No
Comma-separated tags to watch, for example Emotet,mirai. Leave empty to fire for every new malware URL.
Event inputs
URLhaus ID
string
Yes
URLhaus's identifier for the new entry. Default: .
URL
string
Yes
The newly reported malware URL. Default: .
Status
string
No
Whether the URL is currently serving its payload.
Host
string
No
The domain or IP serving the URL.
Reported at
string
No
When the URL was added to URLhaus.
Threat type
string
No
What kind of threat the URL represents.
Reported by
string
No
The URLhaus account that reported it.
Tags
array
No
Malware family and file-type tags on the URL.
URLhaus page
string
No
Link to the human-readable URLhaus entry.
Outputs
URLhaus ID
string
URLhaus's identifier for the new entry.
URL
string
The newly reported malware URL.
Status
string
Whether the URL is currently serving its payload.
Host
string
The domain or IP serving the URL.
Reported at
datetime
When the URL was added to URLhaus.
Threat type
string
What kind of threat the URL represents.
Reported by
string
The URLhaus account that reported it.
Tags
string_array
Malware family and file-type tags on the URL.
URLhaus page
string
Link to the human-readable URLhaus entry.
New Malware Sample
Starts the workflow for each new malware sample URLhaus sees, optionally narrowed to one malware family.
Setup only needs an abuse.ch connection. Optionally restrict to one malware family (e.g. Emotet); leave empty to fire on every new sample, including unattributed ones. The feed returns at most 1000 samples per poll; higher volume between polls can cause missed samples.
Configuration
Only this malware family
string
No
Watch only one malware family, for example Emotet. Leave empty to fire for every new sample.
Event inputs
SHA-256
string
No
The sample's SHA-256 hash.
MD5
string
No
The sample's MD5 hash.
File type
string
No
The kind of file, for example exe or elf.
File size (bytes)
integer
No
The sample's size in bytes.
Malware family
string
No
The malware family the sample was attributed to.
First seen
string
No
When URLhaus first saw the sample.
VirusTotal detection rate
string
No
Share of VirusTotal engines that flagged the sample.
VirusTotal report
string
No
Link to the VirusTotal report.
Import hash
string
No
Import-table hash, used to cluster related Windows binaries.
Sample download link
string
No
URLhaus link to the raw sample, for handing to a malware sandbox.
Outputs
SHA-256
string
The sample's SHA-256 hash.
MD5
string
The sample's MD5 hash.
File type
string
The kind of file, for example exe or elf.
File size (bytes)
integer
The sample's size in bytes.
Malware family
string
The malware family the sample was attributed to.
First seen
datetime
When URLhaus first saw the sample.
VirusTotal detection rate
string
Share of VirusTotal engines that flagged the sample.
VirusTotal report
string
Link to the VirusTotal report.
Import hash
string
Import-table hash, used to cluster related Windows binaries.
Sample download link
string
URLhaus link to the raw sample, for handing to a malware sandbox.
Important behavior
Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.
The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.
Last updated
Was this helpful?

