Malware Threat Map

Rank malware families by prevalence and opportunity scores for your primary organization.

What this endpoint does

Returns the malware threat map for the API token's primary organization — a ranked view of malware families by their global prevalence and opportunity to target your organization. Filter by malware entity IDs, category IDs (from Malware Categories), or watchlist IDs. An empty request body returns the full map. For multi-organization enterprises, use Malware Threat Map (Org) with an org ID from Available Threat Maps.

Response data

Returns a ranked list of malware families with prevalence (0–100, global spread) and opportunity (0–100, targeting relevance to your org) scores, plus watchlist-triggered log entries that explain why each family appears. Log entries track capability and intent signals over time per watchlist entity.

Body Params

Malware threat map filters

malware
array of strings

An array of malware entity IDs. If used, the API response will be limited to only those malware whose entity IDs match those found in the array. To lookup a malware entity ID, use the Entity Match API.

malware
categories
array of strings

An array of malware category entity IDs. If used, the API response will be filtered to only those malware whose category (e.g., Adware, Ransomware, Spyware) matches those found in the array. Categories must be listed by their Recorded Future Entity ID, which can be found by using the Malware Categories endpoint within the Threat API.

categories
watchlists
array of strings

An array of client specific watch list IDs. If used, the API response will be limited to only those threat actors whose link to the threat map is via the watch lists included. To lookup a watch list ID, use the List API.

watchlists
Response

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json