Developers
***Musubu is also available as an API.***
Check out our WordPress plugin @: https://wpthreat.co/
USAGE:
https://api.musubu.io/MusubuAPI/Musubu?IP={IP_ADDRESS}&key={API_KEY}&format={FORMAT}&level={LEVEL}
PARAMETERS | |
---|---|
IP | REQUIRED. The IPv4 address to investigate (in 4-octet dot notation). |
key | REQUIRED. Your API key string. |
format | Takes the values "TEXT" or "JSON". Default is "JSON".
Note: the results will always be returned as JSON; this value sets HttpResponse type. If set to JSON, some browsers (for instance, Internet Explorer) will download the result as a JSON file instead of displaying the results in your browser. |
level | Takes the values "terse" or "verbose". Default is "terse". |
TERSE OUTPUT | |
---|---|
ipaddress | IPv4 address in 4-octet dot notation, from 0.0.0.0 to 255.255.255.255 |
threat_potential_score_pct | Numeric threat score. Integer 0-100. |
threat_classification | Overall characterization of threat. String, with one of the following values:
High Medium Low Nuisance |
EXAMPLE TERSE OUTPUT:
{
"ipaddress":"204.16.0.243",
"threat_potential_score_pct":"82",
"threat_classification":"High"
}
VERBOSE OUTPUT | |
---|---|
ipaddress | IPv4 address in 4-octet dot notation, from 0.0.0.0 to 255.255.255.255 |
ipint | IPv4 address as 8 byte integer representation. Integer 0-4294967295. |
threat_potential_score_pct | Numeric threat score. Integer 0-100. |
threat_classification | Overall characterization of threat. String, with one of the following values:
High Medium Low Nuisance |
blacklist_class | String, with one of the following values:
apache blacklisted botnet botnetcnc bruteforce compromised ftp http imap malware phishing ransomware shunned sips ssh tor worm zeus |
blacklist_class_cnt | Count of distinct sources which have identified the address as malicious. Integer. |
blacklist_network_neighbors | Count of addresses present on the same subnet which have been identified as malicious. Integer. |
blacklist_observations | Count of observations in the last 90 days. Integer. |
country | Two character country designation based on ISO 3166-1 alpha-2. String. |
stateprov | State or province. String. |
district | String. |
city | String. |
zipcode | String. |