Skip to main content
Detection Playbooks

Hands-on detection
engineering

Detection rules, integration guides and incident response playbooks, all calling the public REST API at api.ismalicious.com.

No credit card required · No monthly cap on website lookups · 250 API requests/month

Library

All playbooks

Filter by difficulty or role. Each card shows the minimum plan needed to run the API examples.

Difficulty
Role
Showing 8 of 8
Ingest Threat Intelligence over TAXII Without Vendor Tools
Intermediate45 min10 min2026-08-24

Ingest Threat Intelligence over TAXII Without Vendor Tools

Share and ingest threat intelligence using open standards: pull STIX 2.1 indicators from a TAXII 2.1 feed with curl, jq, and cron — then plug the same feed into Splunk, Elastic, OpenCTI, or MISP.

A daily TAXII 2.1 sync that walks the full isMalicious indicator set with curl and cron, stays incremental with added_after, and feeds your SIEM or TIP — using nothing but open standards.

curljqcronSplunkOpenCTIMISP
Jean-Vincent QUILICHINIJean-Vincent QUILICHINI
STIX/TAXII feeds: Pro plan and up
Open playbook
Lightweight Reputation Checks vs Full Threat Analysis
Beginner15 min3 min2026-03-20

Lightweight Reputation Checks vs Full Threat Analysis

Choose GET /check/reputation when you only need vendor-style verdict counts, and reserve GET /check for investigations. Includes curl examples and when to add /check/whois or /check/location.

A clear decision tree for API calls: faster reputation polling for high-volume paths, full /check for triage, and narrow endpoints for geo or WHOIS-only questions.

isMalicious APIcurlPython
Jean-Vincent QUILICHINIJean-Vincent QUILICHINI
Free key · 250 API requests/month
Open playbook
Automating Malicious IP and Domain Blocklist Downloads
Beginner30 min3 min2026-03-18

Automating Malicious IP and Domain Blocklist Downloads

Use GET /blocklist/stats for freshness, then GET /blocklist/download/{filename} to pull plain-text lists into your WAF, DNS firewall, or SOAR— with curl, diff, and cron-friendly patterns.

A scheduled job that downloads the correct blocklist file for your plan, detects changes, and feeds only deltas into downstream controls—aligned with the public HTTP API.

isMalicious APIcurlbashcron
Jean-Vincent QUILICHINIJean-Vincent QUILICHINI
Free: sample list · full lists on paid plans
Open playbook
Bulk IOC Triage with the isMalicious Batch API
Beginner25 min3 min2026-03-15

Bulk IOC Triage with the isMalicious Batch API

Turn a CSV or SIEM export into scored verdicts in minutes. Use GET /bulk/check for limits, then POST /bulk/check with mixed domains, IPs, and URLs—curl and Python included.

A repeatable batch pipeline that classifies hundreds of IOCs per run with per-entity malicious flags, confidence, source counts, and categories—without hammering single-entity endpoints.

isMalicious APIcurlPythonCSV
Jean-Vincent QUILICHINIJean-Vincent QUILICHINI
Free key · 250 API requests/month
Open playbook
Phishing Domain Detection with Typosquatting Analysis
Intermediate60 min4 min2026-03-08

Phishing Domain Detection with Typosquatting Analysis

Build an automated pipeline to detect phishing domains targeting your brand. Uses typosquatting generation, DNS resolution, and isMalicious reputation checks to catch threats before victims do.

An automated daily scan that detects typosquatting domains targeting your brand, with live reputation checking and alerting when a suspicious domain becomes active.

PythonisMalicious APIdnstwistWazuh
Jean-Vincent QUILICHINIJean-Vincent QUILICHINI
Free key · 250 API requests/month
Open playbook
Blocking Malicious IPs with Firewall Automation
Beginner20 min4 min2026-03-05

Blocking Malicious IPs with Firewall Automation

Automatically update firewall blocklists using isMalicious threat data. Covers pfSense, iptables, Palo Alto, and cloud security groups (AWS/GCP/Azure). Zero manual effort after setup.

A cron-driven pipeline that automatically blocks malicious IPs at the network edge, updated every 6 hours from observed threat activity intelligence.

isMalicious APIPythoniptablespfSenseAWS
Jean-Vincent QUILICHINIJean-Vincent QUILICHINI
TAXII feed: Pro plan and up · Free: bulk check
Open playbook
Enriching SIEM Alerts with isMalicious Threat Intel
Beginner30 min4 min2026-03-01

Enriching SIEM Alerts with isMalicious Threat Intel

Integrate isMalicious API into Splunk and Elastic to auto-enrich every alert with IP/domain reputation, categories, and risk scores. Includes lookup tables and correlation searches.

Every SIEM alert automatically enriched with threat reputation, category, and confidence score — cutting triage time by up to 60%.

SplunkElastic SIEMisMalicious APIPython
Jean-Vincent QUILICHINIJean-Vincent QUILICHINI
Free key · 250 API requests/month
Open playbook
Detecting C2 Beacons with YARA Rules
Intermediate45 min6 min2026-02-17

Detecting C2 Beacons with YARA Rules

Build and deploy YARA rules to detect Command & Control beacon traffic in your network. Includes copy-paste rules for Cobalt Strike, Sliver, and Metasploit.

A set of production-ready YARA rules that detect Cobalt Strike, Sliver, and Metasploit C2 beacons, integrated into your SIEM pipeline.

YARASplunkElasticisMalicious API
Jean-Vincent QUILICHINIJean-Vincent QUILICHINI
Free key · 250 API requests/month
Open playbook

API

Endpoints used in these playbooks

Guides reference the same contract as the OpenAPI spec.

  • GETapi.ismalicious.com/check

    Full threat analysis (query + optional enrichment level)

  • GETapi.ismalicious.com/check/reputation

    Aggregated reputation counts (lighter than full /check)

  • GETapi.ismalicious.com/bulk/check

    Plan limits and usage for batch lookups

  • POSTapi.ismalicious.com/bulk/check

    Batch domains, IPs, and URLs in one JSON request

  • GETapi.ismalicious.com/blocklist/stats

    Entry counts and last-updated times (no auth)

  • GETapi.ismalicious.com/blocklist/download/blocklist-ips-critical.txt

    Plain-text blocklists (plan-gated full vs sample)

FAQ

Frequently asked questions

What are isMalicious playbooks?

Step-by-step guides for security teams: detection rules (YARA, SIEM), incident response workflows and integrations that call the public API at https://api.ismalicious.com, with copy-paste examples.

How do I authenticate API calls in these guides?

Send the X-API-KEY header with your apiKey:apiSecret, Base64-encoded, from the dashboard (Account → API). The same header works for /check, /bulk/check and blocklist downloads.

Where is the official API reference?

Interactive docs and the OpenAPI spec are at ismalicious.com/api-docs. Try requests in the API Playground at ismalicious.com/api-docs/playground.

Do playbooks replace the web report or dashboard?

No. The dashboard and reports serve analysts; playbooks automate the same intelligence in your SIEM, firewalls or scripts through the REST API.

Are rate limits and plan tiers documented?

Yes. Free includes website lookups with no monthly cap, rate-limited API access (250 requests a month), batches of up to 10 indicators and 5 monitored entities; Pro (€99/month) raises that to 10,000 requests a month and adds larger batches, more monitored entities, the SSE stream and webhooks. The full matrix is on /pricing.

Run any of these today

Try any playbook on the Free tier; daily runs, bulk and streaming workflows fit Pro.

No credit card required · No monthly cap on website lookups · 250 API requests/month

Get new playbooks by email

One short email when we publish. No spam, unsubscribe anytime.