Changes as of February 13th, 2017
- You can now react to data you consume in ThreatExchange. Descriptors can be marked as 'HELPFUL', 'NOT_HELPFUL', 'OUTDATED', 'SAW_THIS_TOO', and 'WANT MORE INFO' by anyone who can see them.
- A new edge, /similar_malware, can now be used to identify malware samples we believe are related.
- We've also rolled out additional Webhooks support for ThreatIndicators and ThreatTags, so your servers can be notified in real-time when new threat intel is available.
- Our 'strict_text' search parameter now limits search result to exactly the search term you have submitted. For example, before this change, if you did a search for threat indicators with strict text enabled for 'google.com', you would get a lot of results, including things like “http://google[.]com/fusiontables” and ”http://google.com-136[.]net/DE/1/?subid=1485323323mb29920939890”. The new search will return results for only google.com, i.e. ID 826838047363868. When searching for threat descriptors, you can still use other parameters to limit the search results (e.g. owner or status). If you want to find www.google.com , you have to search for that separately. A strict text search for google.com will not return www.google.com.
Changes in API Version 2.8 (Oct 5th 2016)
You can now add ThreatTags to MalwareAnalyses, ThreatDescriptors, and MalwareFamilies. You can also filter search results by tags and find a list of tags people are using in ThreatExchange via the /threat_tags endpoint.
ThreatExchange now supports Webhooks. With Webhooks support for MalwareAnalyses, ThreatDescriptors, and MalwareFamilies, your server can be notified in realtime when new threat intelligence is added to ThreatExchange. Please see our Webhooks For ThreatExchange Guide for plug-and-play code.
A new parameter in Threatexchange, 'sort_by', allows you to choose whether to sort search results by RELEVANCE or by CREATE_TIME. When sorting by RELEVANCE, your query will return results sorted by similarity against your text query.
- AttackType and ThreatType are being deprecated in favor of ThreatTags. If you publish or read threat data using these fields, you will need to change your code to use ThreatTags instead. Starting December 5th 2016 these fields will no longer be accessible on all versions of the Graph API. To ease the transition, during the interim you'll be able to continue the use of these types on previous versions of the Graph API, alongside tags. We are also making the existing threat_type or attack_type data values available through tags. More specifically, if existing or new threat data has value to these types, the object will automatically be tagged with the equivalent string value. By the end of this period, you'll need to fully transition to use tags instead of threat_type or attack_type.
Changes in API Version 2.4
There were a large number of changes made in Platform version 2.4. You may continue to use Platform version 2.3, without those changes, until 8 Dec 2015. On that day support for version 2.3 will be disabled.
The most important change in version 2.4 was was the introduction of the descriptor model. On version 2.3 and below, all data was stored on the indicator. Beginning with version 2.4, we split information into objective and subjective categories. Objective information is data which everybody can see and agree upon. It may change over time, but everybody sees the same data. For example, the WHOIS registration for a domain name is objective. Subjective information represents somebody's opinion on the data. Different people may have different opinions. For example, the status of a domain as being MALICIOUS or NON_MALICIOUS.
Objective information will remain stored on indicators. For the most part, Facebook will be the only party updating objective information. Subjective information is now stored on a new structure called a descriptor. We have added API calls to create, edit, and search for descriptors. Each AppID may have one descriptor per indicator. Each descriptor has an edge connecting it to a threat indicator. Each indicator has edges to one or more descriptors.
We currently do not support connections between descriptors. Connections between indicators will remain the only way to associate threat information for the time being.