URLAbuse-API-Doc

URLAbuse API Documentation. We provide the following API endpoints for reporters. Please ask for a token before using the API.

Table of Content

• API Report for organizations

report_url

API endpoint: https://zapi.urlabuse.com/feed/report_url

Brief: Report a URL to URLAbuse (urlabuse.com)

Description: Using this API, you can report malicious activity to URLAbuse. This API is only given to trusted third-parties who want to report URL to URLAbuse.

data_type can be one of the phishing, malware, hacked, scam and, bet

URL must start with http:// or https://

Input Parameters

#	Name	Type	Presence	Description
1	token	string	Mandatory	The token to access to the API
2	url	string	Mandatory	The URL to report
3	data_type	string	Mandatory	The type of malicious activity
4	target	string	Optional	The target of the attack in case of phishing/scam
5	geofenced	string	Optional	Two-letter country code to open the phishing URL
6	reporter	string	optional	The name of the reporter (will appear in the feed)

Return Value

Return Type: JSON

Description: returns a JSON structure with the necessary fileds.

Example

# Report a malicious activity to URLAbuse
import requests, json, sys
to_report_url = 'https://paypal-support.com/malicious_login.php'
url = "https://zapi.urlabuse.com/feed/report_url
data_type = 'phishing'
target = 'PayPal'
geofenced = 'US'
params = {"token": "YOUR-TOKEN-HERE", "target": target, "data_type": data_type,
          "url": url, "geofenced": geofenced}
r = requests.get(url, params=params, timeout=10)
if r.status_code != 200:
    print("Failed to get the result from service")
    sys.exit(1)
result = json.loads(r.text)
print(result)

Output

{
    "success": true,
    "code": 200,
    "msg": "Reported successfully"
}