get_threat_profile_recommendations
Retrieve threat objects recommended or manually added to a Threat Profile, including actors, malware, campaigns, and IoCs, based on targeted industries and regions.
Instructions
Returns the list of objects associated to a given Threat Profile.
Each of these objects has one of the following types:
Threat Actors
Malware Families
Software or Toolkits
Campaigns
IoC Collections
Reports
Vulnerabilities
We can distinguish between two other types of objects based on how they were associated with the Threat Profile:
Recommended objects are automatically recommended or assigned to a Threat Profile based on our proprietary ML that takes into account the Threat Profile's configured interests such as the targeted industries, target regions, source regions, malware roles and actor motivations to recommend the most relevant threats. These objects are identified by the presence of "source": "SOURCE_RECOMMENDATION" within the "context_attributes" response parameter below.
Added objects are assigned or added by users to a Threat Profile, when users find other relevant threats not automatically recommended by our ML module. These objects are identified by the presence of "source": "SOURCE_DIRECT_FOLLOW" within the "context_attributes" response parameter below.
Args: profile_id (str): Threat Profile identifier at Google Threat Intelligence. limit: Limit the number of objects to retrieve. 10 by default.
Returns: List of Threat (collection) objects identifiers associated to the Threat Profile. Use
get_collection_reportto retrieve the full objects.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| profile_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |