# AlienVault OTX

> Check IP addresses, domains, URLs and file hashes against AlienVault OTX's community threat reports, and read and search those reports. Works without an account.

App · 7 actions. Web page: https://docs.lodol.com/docs/integrations/alienvault-otx

## Actions

### Check domain

Find out whether a domain, such as example.com, appears in OTX threat reports, with the malware and adversaries they name, and whether OTX lists it as harmless.

**Inputs**

- Domain (`domain`, text, required): The domain, such as example.com. A web address is cut to its domain.

**Outputs**

- `adversaries` (list): Adversaries named by the pulses
- `asn` (text): For an IP address, its network, such as AS15169 google llc
- `country` (text): For an IP address, its country
- `harmless_reasons` (list): Why OTX lists it as harmless
- `in_threat_reports` (true/false): True when any pulse mentions it
- `indicator` (text): The indicator checked
- `industries` (list): Industries the pulses say were targeted
- `known_harmless` (true/false): True when OTX lists it as known and harmless, such as a popular site
- `malware_families` (list): Malware families named by the pulses
- `otx_url` (text): The indicator's page on OTX
- `pulse_count` (number): How many pulses mention it
- `pulses` (list): The newest 10 pulses that mention it
- `reputation` (number): OTX's reputation score, when it has one
- `type` (text): Its kind, such as IPv4, domain or FileHash-SHA256

**Example output**

```json
{
  "adversaries": [],
  "asn": null,
  "country": null,
  "harmless_reasons": [],
  "in_threat_reports": true,
  "indicator": "example.com",
  "industries": [
    "Finance"
  ],
  "known_harmless": false,
  "malware_families": [
    "Emotet"
  ],
  "otx_url": "https://otx.alienvault.com/indicator/domain/example.com",
  "pulse_count": 3,
  "pulses": [
    {
      "adversary": "",
      "author": "noladefense",
      "created": "2023-01-25T11:11:02Z",
      "id": "63d10e46581edfe9bba0da3f",
      "malware_families": [],
      "modified": "2026-10-27T08:37:54Z",
      "name": "Microsoft Phishing Collection",
      "tags": [
        "phishing",
        "microsoft"
      ],
      "tlp": "green",
      "url": "https://otx.alienvault.com/pulse/63d10e46581edfe9bba0da3f"
    }
  ],
  "reputation": null,
  "type": "domain"
}
```

### Check file hash

Find out whether a file is known to OTX, by its MD5, SHA-1 or SHA-256 hash: the threat reports that mention it and what the antivirus engines OTX runs detected it as.

**Inputs**

- File hash (`file_hash`, text, required): The file's MD5, SHA-1 or SHA-256 hash.

**Outputs**

- `adversaries` (list): Adversaries named by the pulses
- `asn` (text): For an IP address, its network, such as AS15169 google llc
- `country` (text): For an IP address, its country
- `detected` (true/false): True when any engine detected it
- `detections` (list): What each antivirus engine detected it as
- `file_type` (text): The kind of file, when OTX has analysed it
- `harmless_reasons` (list): Why OTX lists it as harmless
- `in_threat_reports` (true/false): True when any pulse mentions it
- `indicator` (text): The indicator checked
- `industries` (list): Industries the pulses say were targeted
- `known_harmless` (true/false): True when OTX lists it as known and harmless, such as a popular site
- `malware_families` (list): Malware families named by the pulses
- `otx_url` (text): The indicator's page on OTX
- `pulse_count` (number): How many pulses mention it
- `pulses` (list): The newest 10 pulses that mention it
- `reputation` (number): OTX's reputation score, when it has one
- `sha256` (text): Its SHA-256 hash, when OTX has analysed it
- `type` (text): Its kind, such as IPv4, domain or FileHash-SHA256

**Example output**

```json
{
  "adversaries": [],
  "asn": null,
  "country": null,
  "detected": true,
  "detections": [
    {
      "engine": "clamav",
      "name": "Eicar-Test-Signature"
    }
  ],
  "file_type": "EICAR virus test files",
  "harmless_reasons": [],
  "in_threat_reports": true,
  "indicator": "44d88612fea8a8f36de82e1278abb02f",
  "industries": [
    "Finance"
  ],
  "known_harmless": false,
  "malware_families": [
    "Emotet"
  ],
  "otx_url": "https://otx.alienvault.com/indicator/filehash-md5/44d88612fea8a8f36de82e1278abb02f",
  "pulse_count": 3,
  "pulses": [
    {
      "adversary": "",
      "author": "noladefense",
      "created": "2023-01-25T11:11:02Z",
      "id": "63d10e46581edfe9bba0da3f",
      "malware_families": [],
      "modified": "2026-10-27T08:37:54Z",
      "name": "Microsoft Phishing Collection",
      "tags": [
        "phishing",
        "microsoft"
      ],
      "tlp": "green",
      "url": "https://otx.alienvault.com/pulse/63d10e46581edfe9bba0da3f"
    }
  ],
  "reputation": null,
  "sha256": "275a021bbfb6489e54d471899f7db9d1663fc695ec2fe2a2c4538aabf651fd0f",
  "type": "FileHash-MD5"
}
```

### Check host name

Find out whether one host name, such as login.example.com, appears in OTX threat reports. Use this for a subdomain; 'Check domain' covers the whole domain.

**Inputs**

- Host name (`hostname`, text, required): The host name, such as login.example.com.

**Outputs**

- `adversaries` (list): Adversaries named by the pulses
- `asn` (text): For an IP address, its network, such as AS15169 google llc
- `country` (text): For an IP address, its country
- `harmless_reasons` (list): Why OTX lists it as harmless
- `in_threat_reports` (true/false): True when any pulse mentions it
- `indicator` (text): The indicator checked
- `industries` (list): Industries the pulses say were targeted
- `known_harmless` (true/false): True when OTX lists it as known and harmless, such as a popular site
- `malware_families` (list): Malware families named by the pulses
- `otx_url` (text): The indicator's page on OTX
- `pulse_count` (number): How many pulses mention it
- `pulses` (list): The newest 10 pulses that mention it
- `reputation` (number): OTX's reputation score, when it has one
- `type` (text): Its kind, such as IPv4, domain or FileHash-SHA256

**Example output**

```json
{
  "adversaries": [],
  "asn": null,
  "country": null,
  "harmless_reasons": [],
  "in_threat_reports": true,
  "indicator": "login.example.com",
  "industries": [
    "Finance"
  ],
  "known_harmless": false,
  "malware_families": [
    "Emotet"
  ],
  "otx_url": "https://otx.alienvault.com/indicator/hostname/login.example.com",
  "pulse_count": 3,
  "pulses": [
    {
      "adversary": "",
      "author": "noladefense",
      "created": "2023-01-25T11:11:02Z",
      "id": "63d10e46581edfe9bba0da3f",
      "malware_families": [],
      "modified": "2026-10-27T08:37:54Z",
      "name": "Microsoft Phishing Collection",
      "tags": [
        "phishing",
        "microsoft"
      ],
      "tlp": "green",
      "url": "https://otx.alienvault.com/pulse/63d10e46581edfe9bba0da3f"
    }
  ],
  "reputation": null,
  "type": "hostname"
}
```

### Check IP address

Find out whether an IPv4 or IPv6 address appears in OTX threat reports, with the malware and adversaries they name, its country and network, and whether OTX lists it as harmless.

**Inputs**

- IP address (`ip_address`, text, required): The address, such as 203.0.113.7.

**Outputs**

- `adversaries` (list): Adversaries named by the pulses
- `asn` (text): For an IP address, its network, such as AS15169 google llc
- `country` (text): For an IP address, its country
- `harmless_reasons` (list): Why OTX lists it as harmless
- `in_threat_reports` (true/false): True when any pulse mentions it
- `indicator` (text): The indicator checked
- `industries` (list): Industries the pulses say were targeted
- `known_harmless` (true/false): True when OTX lists it as known and harmless, such as a popular site
- `malware_families` (list): Malware families named by the pulses
- `otx_url` (text): The indicator's page on OTX
- `pulse_count` (number): How many pulses mention it
- `pulses` (list): The newest 10 pulses that mention it
- `reputation` (number): OTX's reputation score, when it has one
- `type` (text): Its kind, such as IPv4, domain or FileHash-SHA256

**Example output**

```json
{
  "adversaries": [],
  "asn": "AS208843 alpha strike labs gmbh",
  "country": "Germany",
  "harmless_reasons": [],
  "in_threat_reports": true,
  "indicator": "45.83.66.65",
  "industries": [
    "Finance"
  ],
  "known_harmless": false,
  "malware_families": [
    "Emotet"
  ],
  "otx_url": "https://otx.alienvault.com/indicator/ipv4/45.83.66.65",
  "pulse_count": 3,
  "pulses": [
    {
      "adversary": "",
      "author": "noladefense",
      "created": "2023-01-25T11:11:02Z",
      "id": "63d10e46581edfe9bba0da3f",
      "malware_families": [],
      "modified": "2026-10-27T08:37:54Z",
      "name": "Microsoft Phishing Collection",
      "tags": [
        "phishing",
        "microsoft"
      ],
      "tlp": "green",
      "url": "https://otx.alienvault.com/pulse/63d10e46581edfe9bba0da3f"
    }
  ],
  "reputation": 0,
  "type": "IPv4"
}
```

### Check URL

Find out whether a web address, such as a link in a reported email, appears in OTX threat reports.

**Inputs**

- URL (`url`, text, required): The full address, such as http://example.com/login.

**Outputs**

- `adversaries` (list): Adversaries named by the pulses
- `asn` (text): For an IP address, its network, such as AS15169 google llc
- `country` (text): For an IP address, its country
- `harmless_reasons` (list): Why OTX lists it as harmless
- `in_threat_reports` (true/false): True when any pulse mentions it
- `indicator` (text): The indicator checked
- `industries` (list): Industries the pulses say were targeted
- `known_harmless` (true/false): True when OTX lists it as known and harmless, such as a popular site
- `malware_families` (list): Malware families named by the pulses
- `otx_url` (text): The indicator's page on OTX
- `pulse_count` (number): How many pulses mention it
- `pulses` (list): The newest 10 pulses that mention it
- `reputation` (number): OTX's reputation score, when it has one
- `type` (text): Its kind, such as IPv4, domain or FileHash-SHA256

**Example output**

```json
{
  "adversaries": [],
  "asn": null,
  "country": null,
  "harmless_reasons": [],
  "in_threat_reports": true,
  "indicator": "http://example.com/login",
  "industries": [
    "Finance"
  ],
  "known_harmless": false,
  "malware_families": [
    "Emotet"
  ],
  "otx_url": "https://otx.alienvault.com/indicator/url/http://example.com/login",
  "pulse_count": 3,
  "pulses": [
    {
      "adversary": "",
      "author": "noladefense",
      "created": "2023-01-25T11:11:02Z",
      "id": "63d10e46581edfe9bba0da3f",
      "malware_families": [],
      "modified": "2026-10-27T08:37:54Z",
      "name": "Microsoft Phishing Collection",
      "tags": [
        "phishing",
        "microsoft"
      ],
      "tlp": "green",
      "url": "https://otx.alienvault.com/pulse/63d10e46581edfe9bba0da3f"
    }
  ],
  "reputation": null,
  "type": "URL"
}
```

### Get pulse

Read one OTX threat report: its description, references, targeted countries and industries, and the indicators it lists (the first 100).

**Inputs**

- Pulse (`pulse_id`, text, required): The pulse's ID or its OTX address, from a check or 'Search pulses'.

**Outputs**

- `adversary` (text): The adversary it names; empty when none
- `attack_ids` (list): MITRE ATT&CK techniques it names
- `author` (text): Who published it on OTX
- `created` (text): When it was published, in UTC (ISO 8601)
- `description` (text): What the pulse is about
- `id` (text): The pulse's ID
- `indicator_count` (number): How many indicators it lists in all
- `indicator_type_counts` (object): How many of each kind, such as domain or IPv4
- `indicators` (list): The first 100 indicators
- `industries` (list): Industries it says were targeted
- `malware_families` (list): The malware families it names
- `modified` (text): When it was last updated, in UTC (ISO 8601)
- `name` (text): The pulse's title
- `references` (list): Its sources, usually links
- `tags` (list): Its tags
- `targeted_countries` (list): Countries it says were targeted
- `tlp` (text): How widely it may be shared: white, green, amber or red
- `url` (text): Its page on OTX

**Example output**

```json
{
  "adversary": "",
  "attack_ids": [],
  "author": "noladefense",
  "created": "2023-01-25T11:11:02Z",
  "description": "Newly observed Microsoft phishing pages.",
  "id": "63d10e46581edfe9bba0da3f",
  "indicator_count": 1,
  "indicator_type_counts": {
    "URL": 1
  },
  "indicators": [
    {
      "created": "2026-10-27T08:37:54Z",
      "indicator": "http://login-example.test/office",
      "type": "URL"
    }
  ],
  "industries": [],
  "malware_families": [],
  "modified": "2026-10-27T08:37:54Z",
  "name": "Microsoft Phishing Collection",
  "references": [
    "https://example.com/report"
  ],
  "tags": [
    "phishing",
    "microsoft"
  ],
  "targeted_countries": [],
  "tlp": "green",
  "url": "https://otx.alienvault.com/pulse/63d10e46581edfe9bba0da3f"
}
```

### Search pulses

Find OTX threat reports by words, such as a malware family, a campaign or a vulnerability. Needs an OTX key on the connection.

**Inputs**

- Search for (`query`, text, required): Words to search for, such as emotet or CVE-2024-3400.
- Order (`sort`, text): Defaults to recently updated first. One of: `-modified` (Recently updated first), `-created` (Newest first), `-subscriber_count` (Most followed first). Default: `-modified`.
- Limit (`limit`, number): How many to return, up to 50. Defaults to 10. From 1 to 50.

**Outputs**

- `count` (number): How many were returned
- `pulses` (list): The matching pulses
- `query` (text): The words searched for
- `total_count` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "pulses": [
    {
      "adversary": "",
      "author": "noladefense",
      "created": "2023-01-25T11:11:02Z",
      "id": "63d10e46581edfe9bba0da3f",
      "malware_families": [],
      "modified": "2026-10-27T08:37:54Z",
      "name": "Microsoft Phishing Collection",
      "tags": [
        "phishing",
        "microsoft"
      ],
      "tlp": "green",
      "url": "https://otx.alienvault.com/pulse/63d10e46581edfe9bba0da3f"
    }
  ],
  "query": "phishing",
  "total_count": 1
}
```
