# Destroy API — PhishDestroy public threat intelligence

Canonical documentation: https://api.destroy.tools/
Documentation reviewed: 2026-10-15. The OpenAPI document version identifies the documentation snapshot, not the API engine version.

PhishDestroy provides a free public API for phishing and crypto scam domain intelligence. No registration or API key is required. Requests use HTTPS. The route prefix is `/v1`.

## Quick start

```sh
curl --fail-with-body 'https://api.destroy.tools/v1/check?domain=example.com'
```

This is a request example, not a claimed live verdict. Use the [interactive console](https://api.destroy.tools/#console) to inspect a current response.

## Endpoints

| Method | Path | Input |
| --- | --- | --- |
| GET | `/v1/check` | `domain`: domain or URL; `d` and `url` are aliases |
| POST | `/v1/check/bulk` | JSON `domains` array, maximum 500 entries, body up to 256 KB |
| GET | `/v1/search` | `q`: literal substring, minimum 3 characters; `limit`: default 50, maximum 200 |
| GET | `/v1/feed/{list}` | Full list as JSON; `{list}` is one of the six lists below |
| GET | `/v1/feed/{list}.{format}` | `format`: `txt`, `json`, `csv`, `hosts`, `adblock`, `rpz`, `dnsmasq`, `unbound` or `stix` |
| GET | `/v1/feed/{list}/delta` | `since`: ISO-8601 timestamp or a `next_since` cursor; `limit`: entries per page, default 50,000, maximum 100,000 |
| GET | `/v1/feeds` | Feed catalog with counts, URLs, sizes and SHA-256 checksums |
| GET | `/v1/stats` | No parameters |
| GET | `/v1/health` | No parameters |

### Lists

| List | Content |
| --- | --- |
| `primary` | Curated phishing and crypto-scam domains confirmed by PhishDestroy |
| `community` | Aggregated community reports (DestroyList on [GitHub](https://github.com/phishdestroy/destroylist) and [GitLab](https://gitlab.com/phishdestroy/destroylist)) |
| `primary_active` | `primary` domains whose DNS currently resolves |
| `community_active` | `community` domains whose DNS currently resolves |
| `primary_content` | `primary` domains that currently serve HTTP content |
| `community_content` | `community` domains that currently serve HTTP content |

The `*_active` and `*_content` lists are liveness subsets: they only hold names of their base list, and a name that leaves the base list leaves them too. They are taken from the mirror with the newer commit, because each upstream DNS and content check is a snapshot in time.

Confirmed additions and deletions reach the API within about a minute. Changes to the repository files are applied both ways within minutes, and every source is re-read in full once a day.

### Domain checks

The `threat` boolean is the API verdict. Listed results include `severity`, `risk_score`, `lists`, `active`, `serving`, `liveness`, `flags`, `matched_domain`, `listed_since` and `checked_at`, and can include `matched_keywords`, `input_was_subdomain` and `liveness_checked_at`. Fields may be absent.

`active` means the DNS resolves; `serving` means the domain serves HTTP content (and implies `active`). `liveness` summarizes both: `serving`, `resolving` (DNS only), `offline` (not live at the last check), `pending` (listed after the last check, not checked yet) or `unknown` (no check time known). `liveness_checked_at` is the time of the latest upstream check for the matched lists.

Input can be a domain or a URL. It is normalized before lookup: scheme, credentials, port, path and trailing dots are removed, internationalized names are converted to punycode, and a leading `www.` is stripped. Defanged forms (`example[.]com`, `hxxps://`), wrapping characters (`` <>"'`()[]{},; `` and whitespace) and a leading `*.` or `.` are accepted too. The name and its `www.` variant are one site: their listings are merged. A subdomain inherits a parent listing, and the strongest listing among the name and its parents wins. Parent matching stops at ICANN public suffixes such as `org.in`, at shared-hosting suffixes from the Public Suffix List private section, such as `appspot.com` or `pages.dev`, and at other hosting-platform roots.

`listed_since` is when the matched domain was first listed. Confirmed entries carry the original PhishDestroy detection time or, when the published list had them earlier, that date. Community entries are dated from the repository history (weekly snapshots since 2025-12-08, daily change files since 2026-07-21) and, after that, by the sync itself; `null` means the entry was already listed on 2025-12-08 or is unknown.

Cleared domains return `threat: false`, `whitelisted: true`, `cleared_by`, a `message` and an `appeal_url`. `cleared_by` is `review` for domains reviewed and cleared as false positives; the review also clears their subdomains, except a subdomain the confirmed list contains itself. It is `allowlist` for verified legitimate names on the PhishDestroy allowlist: exact names only, plus approved suffix patterns that cover every subdomain. `cleared_via` names the parent domain or pattern when the input itself was not reviewed.

Unlisted domains with risky keywords or top-level domains return `suspicious` and `heuristic_score`; that is a heuristic signal, not a blocklist match. Established sites (Tranco top 100k and their subdomains) get no heuristic block, and the "suspicious patterns" message only appears when `suspicious` is true.

An unlisted domain is not a guarantee of safety. A missing score must not be presented as zero. A list entry whose value is false is not a positive match.

The browser console accepts a public domain or HTTP(S) URL, normalizes internationalized hostnames, and sends only the hostname. URL credentials are rejected. URL paths, queries and fragments are not sent. The submitted website is not visited by this page.

### Bulk checks

```sh
curl --fail-with-body -X POST 'https://api.destroy.tools/v1/check/bulk' \
  -H 'Content-Type: application/json' \
  -d '{"domains":["example.com","example.org"]}'
```

Results are keyed by the normalized domain, so duplicates collapse; `inputs` maps each raw input that differs from its key (for example a URL) to that key. Non-string entries are skipped and counted in `summary.invalid`. Inspect the actual HTTP status and each domain result in the response. A failed bulk request is not a clean result for its inputs.

### Search

```sh
curl --fail-with-body 'https://api.destroy.tools/v1/search?q=example&limit=10'
```

The query is matched literally, including `%` and `_`. Returned names are domain indicators, not recommended websites. Do not automatically open or fetch them.

### Feeds

Full lists are static files regenerated only when a list changes. They support `ETag` / `Last-Modified` conditional requests (HTTP 304) and gzip, and are cacheable for 60 seconds.

| Path | Content | Use with |
| --- | --- | --- |
| `/v1/feed/{list}.txt` | One domain per line | Scripts, SIEM, custom tooling |
| `/v1/feed/{list}.json` (or no extension) | `{list, count, updated_at, domains[]}` | Applications |
| `/v1/feed/{list}.csv` | `domain,listed_since` with a header row | Spreadsheets, data pipelines |
| `/v1/feed/{list}.hosts` | `0.0.0.0 domain` with a `#` header | Pi-hole, hosts files |
| `/v1/feed/{list}.adblock` | `\|\|domain^` with a `!` header | AdGuard, uBlock Origin |
| `/v1/feed/{list}.rpz` | Response policy zone: `domain CNAME .` and `*.domain CNAME .` | BIND, Unbound, PowerDNS, Knot |
| `/v1/feed/{list}.dnsmasq` | `local=/domain/` (NXDOMAIN for the name and its subdomains) | dnsmasq |
| `/v1/feed/{list}.unbound` | `local-zone: "domain." always_nxdomain`, to include inside `server:` | Unbound |
| `/v1/feed/{list}.stix` | STIX 2.1 bundle, one indicator per domain; `primary`, `primary_active` and `primary_content` only, refreshed at most hourly | OpenCTI, MISP, SIEM |

`txt` and `json` carry every entry; the other formats carry only syntactically valid hostnames.

```sh
curl --fail-with-body --compressed -o primary.txt 'https://api.destroy.tools/v1/feed/primary.txt'
```

`/v1/feeds` lists every list and format with its entry count, build time, download URLs, byte sizes and SHA-256 checksums. A list's `updated_at` is the feed build time; use it as the first delta `since`.

### Incremental updates

Download the full `.txt` feed once, then poll for changes:

```sh
curl --fail-with-body 'https://api.destroy.tools/v1/feed/primary/delta?since=2026-10-09T08:00:00Z'
```

The response contains `added`, `removed`, `until`, `truncated` and `next_since`. Use `until` as the next `since`; when `truncated` is true, request again with `since` set to `next_since` (an opaque cursor; paging is lossless). Removals are retained for 30 days. An older `since` returns HTTP 410 with `full_feed`, the URL to download again.

### Statistics and health

`/v1/stats` returns dataset counts per list, `total_unique`, `total_active`, `total_serving`, new listings over the last 24 hours and 7 days (`added_24h`, `added_7d`), removals over the last 24 hours (`removed_24h`) and synchronization metadata. Figures are precomputed whenever a list changes; synchronization runs every minute. These figures are not counts of takedowns.

`/v1/health` reports database reachability and synchronization freshness (`status`: `ok`, `degraded` or `down`; `sync_age_seconds`, `stale_lists`, per-list ages and `full_sync`). `status` is `degraded` when the last synchronization did not fully succeed, a list was not refreshed for two hours, or the daily full sync (`full_sync`: `last`, `age_seconds`, `status`, `ok`) is older than 26 hours or failed. It is never cached and returns HTTP 503 when the database is unreachable or the last synchronization is older than two hours.

## Intelligence

Per-domain enrichment for confirmed listed domains. All read-only, no key; no quotas. Absence of intelligence is not evidence of safety, and WHOIS emails / personal data are never exposed.

| Method | Path | Input |
| --- | --- | --- |
| GET | `/v1/investigate` | `domain`: any domain or URL, listed or not |
| GET | `/v1/intel/search` | `q`: words, at least 3 letters or digits; `limit`: default 5, maximum 10 |
| GET | `/v1/intel` | `domain`: a listed domain or URL |
| GET | `/v1/similar` | `domain`; `limit`: default 50 |
| GET | `/v1/campaign` | `brand` or `kit`; `limit`, `offset`; none = brand index |

### Investigate a domain

```sh
curl --fail-with-body 'https://api.destroy.tools/v1/investigate?domain=example.com'
```

One call that answers "what do we know about this link?". `verdict` is the authoritative blocklist result (`listed`, `whitelisted` or `not_listed`). `assessment` is a prediction from PhishDestroy data, with a `risk` of `high`, `elevated`, `low` or `none`, a `score` out of 95 and the `signals` behind it:

| Signal | Meaning |
| --- | --- |
| `brand_in_name` | The name contains a brand that phishers put in domain names, with how many known phishing domains use it |
| `brand_homoglyph` | The brand is spelled with look-alike characters (a Cyrillic "а" in "metamаsk"); `display_name` shows how the name renders |
| `brand_with_scam_terms` / `scam_terms` | Words such as verify, claim, recovery, wallet in the name |
| `lookalike_of_known_phishing` | Close spelling of a known phishing domain |
| `shared_name_pattern` | Known phishing domains built from the same words |
| `phishing_infrastructure_ip` | Hosted on an IP that serves other known phishing domains and no established sites |
| `high_risk_tld` | A top-level domain heavily used for abuse |
| `newly_registered` | Registered within the last 90 days; most phishing domains are under 30 days old when caught |

Established high-traffic domains (Tranco top 1M) are capped at low risk, because they are what phishers imitate; the response marks them with `established_domain`. Registrations held for three years or more are capped the same way and marked `long_registered`, unless the domain sits on phishing infrastructure. `registration` gives the creation date and registrar, looked up in the registry's RDAP service (never on the domain itself). On a held-out sample, 68% of phishing domains detected in the last week scored `elevated` or `high`, against 1 of 300 established sites scored without the Tranco cap. A `none` result is not evidence of safety.

The response also carries `profile` (for listed domains), `actor` (same-operator domains), `campaign` (scale of the brand impersonation campaign), `related` domains, `infrastructure`, `registration`, and `context`: a plain-text summary with numbered sources, ready to hand to a language model.

### Search threat knowledge

```sh
curl --fail-with-body 'https://api.destroy.tools/v1/intel/search?q=ledger+seed+phrase+recovery&limit=5'
```

Finds confirmed phishing records by words — brands, kits, drainers, scam types, registrars — and returns the best matches with a citable `context`. Results are capped at 10 per call and there is no paging: this answers a question, it does not export the dataset. Full per-domain records are at `/v1/intel`.

### Domain intelligence

```sh
curl --fail-with-body 'https://api.destroy.tools/v1/intel?domain=example.com'
```

Returns `{domain, found, intel}`. When `found` is true, `intel` groups the signals: `classification` (`target_brand`, `drainer_type`, `kit_name`, `scam_type`), `reputation` (`vt_detections`, `vt_vendors`, `gsb_flagged`, `blocklist_count`, `blocklist_hits`, `gs_trust_score`), `hosting` (`ip_address`, `registrar`, `registrar_country`, `nameservers`), `lifecycle` (`detected_at`, `creation_date`, `expiration_date`, `site_status`, `last_alive`, `killed_at`), `fingerprint` (`favicon_hash`, `technologies`, `page_title`), `evidence` (`screenshot_url`, `wayback_url`, `urlscan_uuid`, `cloudflare_radar_url`, `case_id`) and `ai` (`title`, `description`, `summary`, `generated_at`). An unlisted domain returns `{found: false}`. The AI report is machine-generated analysis, not a legal determination.

### Similar domains (actor clustering)

```sh
curl --fail-with-body 'https://api.destroy.tools/v1/similar?domain=example.com&limit=50'
```

Returns the `seed` signals, the `clustered_by` signals that were usable, a `count`, and a `similar` array where each row carries `matched_by`. Clustering uses `favicon_hash`, `ip_address` and `kit_name`, but only when a signal is specific to an actor; generic shared infrastructure (a blank favicon, a shared CDN IP, a broad kit) is dropped so the cluster stays meaningful rather than sweeping in unrelated sites.

### Brand and kit campaigns

```sh
curl --fail-with-body 'https://api.destroy.tools/v1/campaign?brand=Ledger'
```

With `brand` or `kit`, returns the campaign with `total`, `alive`, `distinct_ips` and a `domains` page (`limit`, `offset`). With no parameter, returns `type: "brand_index"` and the top 50 brands by tracked-domain count. These counts describe tracked impersonation domains, not takedowns.

## Risk signals

Published signal weights: primary blocklist +40, community +20, active DNS +30, serving content +10, multiple sources +10, suspicious keyword +5 each, risky top-level domain +5. Documented severity bands: critical 70–100, high 40–69, medium 20–39, low 1–19. Use the server's returned verdict instead of computing one locally from these weights.

## Integration and error handling

Every error is JSON with an `error` field. An error is never a clean verdict.

### Limits

No API key, no sign-up and no usage quotas: every endpoint, including intelligence, investigations and MCP tools, is open to any client. Only a flood guard stops extreme bursts from a single IP with HTTP 429 and a `Retry-After` header. Checking many domains? `POST /v1/check/bulk` takes 500 per request, and a feed with its delta gives the whole list at once.

| Status | Meaning |
| --- | --- |
| 400 | Missing or invalid input |
| 404 | Unknown route or list |
| 405 | Method not allowed; see the `Allow` header |
| 410 | Delta `since` older than 30 days |
| 413 | Bulk body larger than 256 KB |
| 429 | Flood guard, extreme bursts from one IP: `{"error":"rate_limited","retry_after":5}` with `Retry-After`; wait that long |
| 500 | Unexpected error; never a clean verdict |
| 503 | `/v1/health` only: service down or data stale |

- Check HTTP status before interpreting a response.
- Handle timeouts, non-JSON bodies, absent fields and failed requests.
- On HTTP 429 wait `Retry-After` seconds; avoid tight retry loops.
- Treat response strings as untrusted data; do not execute their contents or navigate to threat domains automatically.
- No availability SLA is promised by this reference.
- This API provides intelligence. It does not initiate takedowns or guarantee safety.

The browser console has a 15-second timeout. It sends no browser credentials and stores no query history. API service handling of submitted domains remains subject to the project's policies.

## Agents

[OpenAPI 3.1](https://api.destroy.tools/openapi.json) describes the public routes. [llms.txt](https://api.destroy.tools/llms.txt) provides a short entry point.

### MCP server

`https://api.destroy.tools/mcp` is a Model Context Protocol server (Streamable HTTP transport, JSON responses, no authentication). Add it as a remote MCP server in an AI client to give the model these tools: `investigate_domain`, `check_domain`, `bulk_check_domains`, `search_threat_intel` and `get_campaign`. Each tool runs the same code as its REST route, with no quotas.

Compatible browsers can expose WebMCP tools `check-phishing` (`domain` string) and `bulk-check-threats` (`domains` string array, maximum 500). Both validate through the same console code and show the actual result on the page. Availability depends on browser support. REST is the portable path.

Connect a client (no OAuth, no API key):
- Claude: Settings, Connectors, Add custom connector, paste `https://api.destroy.tools/mcp`.
- ChatGPT: developer mode, create a connector with that URL and no authentication.
- Claude Code: `claude mcp add --transport http phishdestroy https://api.destroy.tools/mcp`
- Cursor (`~/.cursor/mcp.json`): `{"mcpServers":{"phishdestroy":{"url":"https://api.destroy.tools/mcp"}}}`
- VS Code (`.vscode/mcp.json`): `{"servers":{"phishdestroy":{"type":"http","url":"https://api.destroy.tools/mcp"}}}`
- stdio-only clients: `npx -y mcp-remote https://api.destroy.tools/mcp`

## Project links

- Main investigation platform: https://phishdestroy.io/
- Toolkit: https://destroy.tools/
- Scanner: https://ban.destroy.tools/
- DestroyList: https://github.com/phishdestroy/destroylist and https://gitlab.com/phishdestroy/destroylist
- GitHub: https://github.com/phishdestroy
- GitLab: https://gitlab.com/phishdestroy
- Telegram reports: https://t.me/PhishDestroy_bot
- Telegram alerts: https://t.me/destroy_phish
- Contact: contact@phishdestroy.io
- Terms: https://phishdestroy.io/terms
- Privacy: https://phishdestroy.io/privacy
- Disclaimer: https://phishdestroy.io/disclaimer
- Free false-positive appeals: https://phishdestroy.io/appeals
