For Agents
Check the reputation of domains, IPs, and URLs against the isMalicious threat intelligence feed — full threat analysis, certificate and WHOIS lookups, plus bulk processing for SOC pipelines.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the isMalicious - Threat Intelligence API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with isMalicious - Threat Intelligence API.
Run a full threat analysis on a domain, IP, or URL covering reputation, geolocation, and certificates in one call
Submit an indicator for community blocklist consideration via POST /submit
Download a blocklist file by name for offline use in firewalls or DNS sinkholes
GET STARTED
Use for: Check whether a domain is malicious, Find the reputation score of an IP address, Get the geolocation of a suspicious IP, Search the threat feed for the keyword 'cobalt strike'
Not supported: Does not handle endpoint detection, malware sandboxing, or vulnerability scanning — use for IP, domain, and URL reputation lookup only.
Jentic publishes the only available OpenAPI specification for isMalicious - Threat Intelligence API, keeping it validated and agent-ready. isMalicious is a threat intelligence service for checking the reputation of domains, IP addresses, and URLs. The 12 endpoints cover full threat analysis, reputation scoring, geolocation, certificate inspection, vulnerability lookup, WHOIS, keyword search, indicator submission, blocklist downloads, and bulk checks for high-volume processing. Plans range from a free tier at 10 requests per minute up to Pro at 300 requests per minute.
Search the threat feed by keyword to find indicators related to a campaign or actor
Run a bulk check across many indicators in one POST request to feed SOC pipelines
Inspect WHOIS data for a domain to support attribution work
Patterns agents use isMalicious - Threat Intelligence API for, with concrete tasks.
★ SOC enrichment of detection alerts
When a SIEM raises an alert containing a suspicious indicator, the SOC pipeline calls GET /check on the IP, domain, or URL. The response combines reputation score, geolocation, and certificate context, letting the analyst triage in seconds rather than chasing the indicator through several separate tools. Integrates well with SOAR playbooks that need a single canonical context call.
For the IP 8.8.8.8, call GET /check and return reputation score, country code, and ASN
Outbound URL filtering for messaging platforms
Inspect URLs in user-submitted content before they reach recipients by calling GET /check/reputation. The agent blocks or warns on URLs whose reputation falls below a threshold, reducing phishing exposure on the platform. The 60 requests per minute Basic tier accommodates moderate-traffic messaging products without needing a custom contract.
For the URL 'https://example.com/login', call GET /check/reputation and reject the message if score is below 30
Threat hunting via keyword search
Hunt across the isMalicious feed for indicators tied to a specific campaign by calling POST /search with a keyword. The endpoint returns matching domains, IPs, and URLs that the analyst can pivot from. Combines naturally with GET /check/whois to build out attribution chains during an active investigation.
Search the feed for the keyword 'qakbot' and return the first 50 matching indicators
Bulk reputation check for blocklist refresh
Refresh an internal blocklist nightly by sending a curated list of suspect indicators to POST /bulk/check. The endpoint returns reputation, recency, and confidence values that the agent uses to keep only currently active malicious indicators in the blocklist. Reduces false positives compared to time-decayed blocklists that never re-validate older entries.
Submit the supplied list of 500 IPs to POST /bulk/check and return only those with reputation below 20
AI security agent answering analyst chat queries
An AI agent embedded in the SOC chat tool answers analyst questions like 'is this domain malicious' by routing through Jentic to GET /check. Through Jentic the agent searches for 'check threat indicator' and the matching isMalicious operation is loaded with the API key already injected. Reduces context-switching between Slack and the threat intel portal.
When asked 'is evil-domain.com malicious', call GET /check with the domain and summarise the reputation verdict
12 endpoints — jentic publishes the only available openapi specification for ismalicious - threat intelligence api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/check
Run a full threat analysis on an indicator
/check/reputation
Get reputation score for an indicator
/check/whois
Get WHOIS data for a domain
/check/certificates
Get TLS certificates for a domain
/search
Search the feed by keyword
/submit
Submit an indicator to the community feed
/bulk/check
Run a bulk indicator check
/blocklist/download/{filename}
Download a named blocklist
/check
Run a full threat analysis on an indicator
/check/reputation
Get reputation score for an indicator
/check/whois
Get WHOIS data for a domain
/check/certificates
Get TLS certificates for a domain
/search
Search the feed by keyword
Three things that make agents converge on Jentic-routed access.
Credential isolation
isMalicious X-API-KEY values are encrypted in the Jentic vault. Agents receive scoped execution tokens — the base64-encoded apiKey:apiSecret never enters the agent context, which matters under SOC change-control policies.
Intent-based discovery
Agents search by intent (e.g. 'check IP reputation' or 'bulk check indicators') and Jentic returns the matching isMalicious operation with its parameter schema and rate-limit metadata.
Time to first call
Direct isMalicious integration: 4-6 hours to wire base64 header auth, error handling, and bulk pagination. Through Jentic: under 30 minutes — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
AbuseIPDB
Community IP abuse database focused on IP-only reputation rather than full domain and URL coverage
Choose AbuseIPDB when only IP reputation matters and the domain context provided by isMalicious is not needed
Specific to using isMalicious - Threat Intelligence API through Jentic.
Why is there no official OpenAPI spec for isMalicious - Threat Intelligence API?
isMalicious does publish a JSON spec at api.ismalicious.com/openapi.json, but it changes frequently and lacks Jentic's enrichment fields. Jentic mirrors and validates this spec so AI agents and developers can call isMalicious via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the isMalicious API use?
isMalicious uses an API key passed in the X-API-KEY request header. The value is the base64 encoding of apiKey:apiSecret obtained from ismalicious.com/app/account. Through Jentic the credential is held in the vault and injected at request time — agents never see the raw value.
Can I run a bulk reputation check in one call?
Yes. POST /bulk/check accepts an array of indicators and returns a per-indicator reputation map. GET /bulk/check returns current usage and remaining quota so the agent can throttle itself before hitting plan caps.
What are the rate limits for the isMalicious API?
Rate limits are tiered: Free 10 per minute and 100 per day, Basic 60 per minute and 5000 per day, Pro 300 per minute and 50000 per day, with custom plans available. Over-quota requests return HTTP 429.
How do I check a single indicator through Jentic?
Search Jentic with the query 'check threat indicator' or 'is this IP malicious', load the GET /check operation, and execute it with the indicator as a query parameter. The response includes reputation score, geolocation, and any vulnerability or WHOIS context that is available.
Does isMalicious return TLS certificate data for domains?
Yes. GET /check/certificates returns the TLS certificates observed for the domain, including issuer, validity window, and SAN list. Useful for spotting certificates issued to lookalike domains during a phishing investigation.
/submit
Submit an indicator to the community feed
/bulk/check
Run a bulk indicator check
/blocklist/download/{filename}
Download a named blocklist