4.4 Scanning list of URLs

Request

Value

Method

POST

URL

https://api.metadefender.com/v3/url

Throttled

Yes

Summary

Retrieve information about a list of given observables (URLs) from CIF server.

Request

Request body

{
"url": [
"http://hdfc.pp.ru/permit/gate.php",
"http://institutobrf.dev.homolog-vorttex.com/wp-info/ibank-loginpage-action-id02384212031934023200/116e6/template/thankyou.php?session'.e08f47e122c772.'?userid'.9f89f4f88e42b86d76.'?formid'.59d96c7e4511aad583cd06e1e7e1de.'",
"http://217.61.57.110/banquepopulaire.fr/banquepopulaire.fr/d1fe2/info/index.html"
]
}

Header Parameters

 

Description

Allowed Values

Required

Authorization

Give rights to use the endpoint (API Authentication Mechanisms)

apikey

YES

Content-type

 

application/json

YES

Response

HTTP Status Codes

Please refer to Status Codes for more information.

Body

Example of successful scan request:

{
"success": true,
"data": [
{
"start_time": "2018-12-06T11:59:49.978Z",
"detected_by": 1,
"url": "http://hdfc.pp.ru/permit/gate.php",
"scan_results": [
{
"source": "zeustracker.abuse.ch",
"results": [
{
"alternativeid": "https://zeustracker.abuse.ch/monitor.php?search={indicator}",
"assessment": "botnet, zeus",
"confident": 90,
"detecttime": "2018-12-05T11:08:29.185484Z",
"updatetime": "2018-12-05T11:08:29.311797",
"result": "blacklisted"
}
]
},
{
"source": "reputation.alienvault.com",
"results": [
{
"alternativeid": "",
"assessment": "",
"confident": "",
"detecttime": "",
"updatetime": "2018-12-06T11:59:50.080Z",
"result": "unknown"
}
]
},
{
"source": "danger.rulez.sk",
"results": [
{
"alternativeid": "",
"assessment": "",
"confident": "",
"detecttime": "",
"updatetime": "2018-12-06T11:59:50.080Z",
"result": "unknown"
}
]
},
{
"source": "feodotracker.abuse.ch",
"results": [
{
"alternativeid": "",
"assessment": "",
"confident": "",
"detecttime": "",
"updatetime": "2018-12-06T11:59:50.080Z",
"result": "unknown"
}
]
},
{
"source": "malc0de.com",
"results": [
{
"alternativeid": "",
"assessment": "",
"confident": "",
"detecttime": "",
"updatetime": "2018-12-06T11:59:50.080Z",
"result": "unknown"
}
]
},
{
"source": "malwaredomainlist.com",
"results": [
{
"alternativeid": "",
"assessment": "",
"confident": "",
"detecttime": "",
"updatetime": "2018-12-06T11:59:50.080Z",
"result": "unknown"
}
]
},
{
"source": "phishtank.com",
"results": [
{
"alternativeid": "",
"assessment": "",
"confident": "",
"detecttime": "",
"updatetime": "2018-12-06T11:59:50.080Z",
"result": "unknown"
}
]
},
{
"source": "spamhaus.org",
"results": [
{
"alternativeid": "",
"assessment": "",
"confident": "",
"detecttime": "",
"updatetime": "2018-12-06T11:59:50.080Z",
"result": "unknown"
}
]
}
]
},
{
"start_time": "2018-12-06T11:59:50.080Z",
"detected_by": 0,
"url": "http://institutobrf.dev.homolog-vorttex.com/wp-info/ibank-loginpage-action-id02384212031934023200/116e6/template/thankyou.php?session'.e08f47e122c772.'?userid'.9f89f4f88e42b86d76.'?formid'.59d96c7e4511aad583cd06e1e7e1de.'",
"scan_results": [
{
"source": "reputation.alienvault.com",
"results": [
{
"alternativeid": "",
"assessment": "",
"confident": "",
"detecttime": "",
"updatetime": "2018-12-06T11:59:50.154Z",
"result": "unknown"
}
]
},
{
"source": "danger.rulez.sk",
"results": [
{
"alternativeid": "",
"assessment": "",
"confident": "",
"detecttime": "",
"updatetime": "2018-12-06T11:59:50.154Z",
"result": "unknown"
}
]
},
{
"source": "feodotracker.abuse.ch",
"results": [
{
"alternativeid": "",
"assessment": "",
"confident": "",
"detecttime": "",
"updatetime": "2018-12-06T11:59:50.154Z",
"result": "unknown"
}
]
},
{
"source": "malc0de.com",
"results": [
{
"alternativeid": "",
"assessment": "",
"confident": "",
"detecttime": "",
"updatetime": "2018-12-06T11:59:50.154Z",
"result": "unknown"
}
]
},
{
"source": "malwaredomainlist.com",
"results": [
{
"alternativeid": "",
"assessment": "",
"confident": "",
"detecttime": "",
"updatetime": "2018-12-06T11:59:50.154Z",
"result": "unknown"
}
]
},
{
"source": "phishtank.com",
"results": [
{
"alternativeid": "",
"assessment": "",
"confident": "",
"detecttime": "",
"updatetime": "2018-12-06T11:59:50.154Z",
"result": "unknown"
}
]
},
{
"source": "spamhaus.org",
"results": [
{
"alternativeid": "",
"assessment": "",
"confident": "",
"detecttime": "",
"updatetime": "2018-12-06T11:59:50.154Z",
"result": "unknown"
}
]
},
{
"source": "zeustracker.abuse.ch",
"results": [
{
"alternativeid": "",
"assessment": "",
"confident": "",
"detecttime": "",
"updatetime": "2018-12-06T11:59:50.154Z",
"result": "unknown"
}
]
}
]
},
{
"start_time": "2018-12-06T11:59:50.154Z",
"detected_by": 0,
"url": "http://217.61.57.110/banquepopulaire.fr/banquepopulaire.fr/d1fe2/info/index.html",
"scan_results": [
{
"source": "reputation.alienvault.com",
"results": [
{
"alternativeid": "",
"assessment": "",
"confident": "",
"detecttime": "",
"updatetime": "2018-12-06T11:59:50.236Z",
"result": "unknown"
}
]
},
{
"source": "danger.rulez.sk",
"results": [
{
"alternativeid": "",
"assessment": "",
"confident": "",
"detecttime": "",
"updatetime": "2018-12-06T11:59:50.236Z",
"result": "unknown"
}
]
},
{
"source": "feodotracker.abuse.ch",
"results": [
{
"alternativeid": "",
"assessment": "",
"confident": "",
"detecttime": "",
"updatetime": "2018-12-06T11:59:50.236Z",
"result": "unknown"
}
]
},
{
"source": "malc0de.com",
"results": [
{
"alternativeid": "",
"assessment": "",
"confident": "",
"detecttime": "",
"updatetime": "2018-12-06T11:59:50.236Z",
"result": "unknown"
}
]
},
{
"source": "malwaredomainlist.com",
"results": [
{
"alternativeid": "",
"assessment": "",
"confident": "",
"detecttime": "",
"updatetime": "2018-12-06T11:59:50.236Z",
"result": "unknown"
}
]
},
{
"source": "phishtank.com",
"results": [
{
"alternativeid": "",
"assessment": "",
"confident": "",
"detecttime": "",
"updatetime": "2018-12-06T11:59:50.236Z",
"result": "unknown"
}
]
},
{
"source": "spamhaus.org",
"results": [
{
"alternativeid": "",
"assessment": "",
"confident": "",
"detecttime": "",
"updatetime": "2018-12-06T11:59:50.236Z",
"result": "unknown"
}
]
},
{
"source": "zeustracker.abuse.ch",
"results": [
{
"alternativeid": "",
"assessment": "",
"confident": "",
"detecttime": "",
"updatetime": "2018-12-06T11:59:50.236Z",
"result": "unknown"
}
]
}
]
}
]
}

Descriptions of response:

data

The information from database.

success

Boolean value representing whether request was successfully resolved or not.

detected_by

Number of blacklisted sources.

source

Source of the feed, usually the domain where the feed is from (e.g., example.com).

alternativeid

Usually a URL pointing to the original data point (as a reference id).

detecttime

When the event was detected, most common timestamp formats are valid.

result

blacklisted, whitelisted, unknown

Errors

Please refer to Errors for more information.

Sample code (Node.js)

var http = require("https");
 
var options = {
"method": "POST",
"hostname": [
"api",
"metadefender",
"com"
],
"path": [
"v3",
"url",
""
],
"headers": {
"Content-Type": "application/json",
"Authorization": "apikey " + process.env.APIKEY
}
};
 
var req = http.request(options, function (res) {
var chunks = [];
 
res.on("data", function (chunk) {
chunks.push(chunk);
});
 
res.on("end", function () {
var body = Buffer.concat(chunks);
console.log(body.toString());
});
});
 
req.write(JSON.stringify({ url:
[ 'http://hdfc.pp.ru/permit/gate.php',
'http://institutobrf.dev.homolog-vorttex.com/wp-info/ibank-loginpage-action-id02384212031934023200/116e6/template/thankyou.php?session\'.e08f47e122c772.\'?userid\'.9f89f4f88e42b86d76.\'?formid\'.59d96c7e4511aad583cd06e1e7e1de.\'',
'http://217.61.57.110/banquepopulaire.fr/banquepopulaire.fr/d1fe2/info/index.html' ] }));
req.end();

Sample code (cURL)

curl -X POST \
https://api.metadefender.com/v3/url/ \
-H 'Authorization: apikey ${APIKEY}' \
-H 'Content-Type: application/json' \
-d '{
"url": [
"http://hdfc.pp.ru/permit/gate.php",
"http://institutobrf.dev.homolog-vorttex.com/wp-info/ibank-loginpage-action-id02384212031934023200/116e6/template/thankyou.php?session'\''.e08f47e122c772.'\''?userid'\''.9f89f4f88e42b86d76.'\''?formid'\''.59d96c7e4511aad583cd06e1e7e1de.'\''",
"http://217.61.57.110/banquepopulaire.fr/banquepopulaire.fr/d1fe2/info/index.html"
]
}'