4.6 Scanning list of domains

Request

Value

Method

POST

URL

https://api.metadefender.com/v4/domain

Throttled

Yes

Summary

Retrieve information about a list of given fully qualified domain names (FQDNs) from CIF server.

Request

Request body

{
"fqdn": ["dd.myapp.tcdn.qq.com", "dd1.yourapp.tcdn.qq.de"]
}

Header Parameters

 

Description

Allowed Values

Required

apikey

Gives rights to use the endpoint (API Authentication Mechanisms)

apikey

YES

Content-type

Specify the http content type

application/json

NO

Response

HTTP Status Codes

Please refer to Status Codes for more information.

Body

Example of a successful request:

{
"data": [
{
"address": "dd.myapp.tcdn.qq.com",
"lookup_results": {
"start_time": "2019-02-28T12:07:59.630Z",
"detected_by": 0,
"sources": [
{
"provider": "reputation.alienvault.com",
"assessment": "",
"detect_time": "",
"update_time": "2019-02-28T12:07:59.783Z",
"status": 0
},
{
"provider": "danger.rulez.sk",
"assessment": "",
"detect_time": "",
"update_time": "2019-02-28T12:07:59.783Z",
"status": 0
},
{
"provider": "feodotracker.abuse.ch",
"assessment": "",
"detect_time": "",
"update_time": "2019-02-28T12:07:59.783Z",
"status": 0
},
{
"provider": "malc0de.com",
"assessment": "",
"detect_time": "",
"update_time": "2019-02-28T12:07:59.783Z",
"status": 0
},
{
"provider": "malwaredomainlist.com",
"assessment": "",
"detect_time": "",
"update_time": "2019-02-28T12:07:59.783Z",
"status": 0
},
{
"provider": "phishtank.com",
"assessment": "",
"detect_time": "",
"update_time": "2019-02-28T12:07:59.783Z",
"status": 0
},
{
"provider": "spamhaus.org",
"assessment": "",
"detect_time": "",
"update_time": "2019-02-28T12:07:59.783Z",
"status": 0
},
{
"provider": "zeustracker.abuse.ch",
"assessment": "",
"detect_time": "",
"update_time": "2019-02-28T12:07:59.783Z",
"status": 0
}
]
}
},
{
"address": "dd1.yourapp.tcdn.qq.de",
"lookup_results": {
"start_time": "2019-02-28T12:07:59.783Z",
"detected_by": 0,
"sources": [
{
"provider": "reputation.alienvault.com",
"assessment": "",
"detect_time": "",
"update_time": "2019-02-28T12:07:59.819Z",
"status": 0
},
{
"provider": "danger.rulez.sk",
"assessment": "",
"detect_time": "",
"update_time": "2019-02-28T12:07:59.819Z",
"status": 0
},
{
"provider": "feodotracker.abuse.ch",
"assessment": "",
"detect_time": "",
"update_time": "2019-02-28T12:07:59.819Z",
"status": 0
},
{
"provider": "malc0de.com",
"assessment": "",
"detect_time": "",
"update_time": "2019-02-28T12:07:59.819Z",
"status": 0
},
{
"provider": "malwaredomainlist.com",
"assessment": "",
"detect_time": "",
"update_time": "2019-02-28T12:07:59.819Z",
"status": 0
},
{
"provider": "phishtank.com",
"assessment": "",
"detect_time": "",
"update_time": "2019-02-28T12:07:59.819Z",
"status": 0
},
{
"provider": "spamhaus.org",
"assessment": "",
"detect_time": "",
"update_time": "2019-02-28T12:07:59.819Z",
"status": 0
},
{
"provider": "zeustracker.abuse.ch",
"assessment": "",
"detect_time": "",
"update_time": "2019-02-28T12:07:59.819Z",
"status": 0
}
]
}
}
]
}

Example of a successful request:

{
"success": false,
"error": {
"code": 400180,
"messages": [
"Invalid format of input. Provide valid domain."
]
}
}

Descriptions of response:

success

A boolean value representing whether the request was successfully resolved or not.

detected_by

The number of blacklisted sources.

sources

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

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": [
"v4",
"domain",
""
],
"headers": {
"Content-Type": "application/json",
"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({ fqdn: [ 'dd.myapp.tcdn.qq.com', 'dd1.yourapp.tcdn.qq.de' ] }));
req.end();

Sample code (cURL)

curl -X POST \
https://api.metadefender.com/v4/domain/ \
-H 'Content-Type: application/json' \
-H "apikey: ${APIKEY}"
-d '{
"fqdn": ["dd.myapp.tcdn.qq.com", "dd1.yourapp.tcdn.qq.de"]
}'