Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

Connector
Authentication

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

  1. Prepare the abuse.ch account or service that the workflow will access. Grant access to the required resources and operations.

  2. 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

  1. Open Settings → Connections, add a connection, and select abuse.ch.

  2. Enter the credentials and connection details in the fields below.

  3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

Connection fields

StackAI field
Required
What to enter

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

  1. Add the required abuse.ch action to the workflow.

  2. Select a connection when the action requests one.

  3. Complete the required fields. Use the reference picker when a value comes from another workflow step.

  4. 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

Field
Type
Required
Description

URL

string

Yes

The full URL to check, including http:// or https://.

Outputs

Field
Type
Description

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

Field
Type
Required
Description

Domain or IP address

string

Yes

The domain, hostname or IP address to check.

Outputs

Field
Type
Description

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

Field
Type
Required
Description

File hash (MD5 or SHA-256)

string

Yes

The MD5 or SHA-256 hash of the file you want to identify.

Outputs

Field
Type
Description

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

Field
Type
Required
Description

Maximum URLs

integer

No

How many of the newest URLs to return. Up to 1000.

Outputs

Field
Type
Description

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

Field
Type
Required
Description

Maximum payloads

integer

No

How many of the newest samples to return. Up to 1000.

Outputs

Field
Type
Description

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

Field
Type
Required
Description

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

Field
Type
Description

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

Field
Type
Required
Description

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

Field
Type
Description

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

Field
Type
Required
Description

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

Field
Type
Description

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

Field
Type
Required
Description

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

Field
Type
Required
Description

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

Field
Type
Description

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

Field
Type
Required
Description

Only this malware family

string

No

Watch only one malware family, for example Emotet. Leave empty to fire for every new sample.

Event inputs

Field
Type
Required
Description

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

Field
Type
Description

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?