# AlienVault OTX Threat Intel API

> Threat intelligence for IPs, domains, URLs, file hashes and CVEs from AlienVault OTX pulses

- Vendor: `alienvaultotxthreatintelapi` · version 1.0 · category Threat Intelligence · tags threat intelligence api, ioc api, ip reputation api, malware api, alienvault otx api, cyber security api, domain reputation api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/alienvaultotxthreatintelapi
- This document: https://apiclay.com/docs/alienvaultotxthreatintelapi.md
- OpenAPI 3.1: https://apiclay.com/api/alienvaultotxthreatintelapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `alienvaultotxthreatintelapi`
- Updated: 2026-11-18

## About

## AlienVault OTX Threat Intel API

Open Threat Exchange (OTX) indicator lookups: for an IP address, domain, hostname, URL, file hash or CVE, get the community pulses that mention it, reputation and allow-list validation, geo data, passive DNS, related URLs, malware samples and HTTP scans.

Data comes from **otx.alienvault.com** (https://otx.alienvault.com). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/indicator?type=IPv4&amp;indicator=8.8.8.8§ion=general`, then other sections such as `geo`, `passive_dns` or `malware` for the same indicator.

### Routes

#### GET `/indicator` - Indicator lookup
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| type | path | string | yes | `IPv4`, `IPv6`, `domain`, `hostname`, `url`, `file` or `cve`. |
| indicator | path | string | yes | The value, e.g. `8.8.8.8`, `google.com`, a SHA-256 hash or `CVE-2021-44228`. |
| section | path | string | yes | `general`, `geo`, `reputation`, `malware`, `url_list`, `passive_dns`, `http_scans`; `whois` for domains, `analysis` for files. |

Returns: for `general`: `indicator`, `type`, `reputation`, `pulse_info` (`count`, `pulses[]` with `name`, `tags`, `adversary`, `malware_families`), `validation[]`, `sections[]`.

### Caveats

- Anonymous lookups are rate limited by OTX; a `url` indicator with slashes cannot be passed as one path value.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by otx.alienvault.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /indicator — Indicator lookup
- Gateway: `GET https://api.apiclay.com/v1/api/alienvaultotxthreatintelapi/indicator`
- Public query params: `type` (string, required), `indicator` (string, required), `section` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/alienvaultotxthreatintelapi/indicator?type=<type>&indicator=<indicator>&section=<section>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
