> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/integrations/catalog/abuse.ch.md).

# 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](https://auth.abuse.ch/). |

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/integrations/catalog/abuse.ch.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
