URLVoid API V1 Beta Tests
Block unknown processes with NoVirusThanks EXE Radar Pro
We had time to finish the first part of the free API service (V1) that allows user to query our database of already analyzed domains and receive, in a simple output, the number of scanning engines that detects the submitted domain.
The API needs a special key to being used and you can request your own API key by contacting us at info (at) novirusthanks (dot) org with the subject Request for URLVoid API Key. To create an API key for you, we need the following details:
1) Your Name / Nickname;
2) Your Email;
3) Your Website URL;
4) Small description on how you are going to use URLVoid API;
All your details will not be shared in any way and will be strictly private and used only to assign the API key to your email, nickname and website. After we have received your email, we will send in few days your API key to your email. Please note that you need to respect the following terms to use correctly our free API:
1) Not include/use the API in commercial products
2) Not include/use the API in commercial services
3) Not include/use the API in commercial purposes
4) Not use the API as substitute for Security products
5) Not use the API in unethical services
6) Include a backlink to our website (urlvoid.com)
7) Not abuse the service usage
Not use the API in services where you have no control
Non-compliance with these rules will result in the termination of your account/API key without prior notification and you will not be able to use the service. At the moment we have set no limit in how many queries you can do in one day, this and other parameters will change in future versions of the API service.
Usage
Request format:
1 | http://api.urlvoid.com/api.php?key=YOUR_KEY&domain=MD5HASH_DOMAIN |
Example:
1 | http://api.urlvoid.com/api.php?key=123abc&domain=1d5920f4b44b27a802bd77c4f0536f5a |
In this example we requested to get details for the analysis of the domain google.com with our API key 123abc. Remember to always use the following rule to analyze subdomains or domains:
1 2 3 | domain.com subdomain.domain.com subdomain.subdomain.domain.com |
Do not include in the domain http:// or www. or final / before convert the domain in hash. As output you will receive the number of scanning engines that detected the submitted domain, example:
1 2 3 4 5 | google.com -> 0 -> CLEAN bestellkanal.tv -> 4 -> DANGEROUS yahoo.com -> 0 -> CLEAN www1.makeptotect76.co.cc -> 3 -> DANGEROUS makeptotect76.co.cc -> 4 -> DANGEROUS |
In case the domain or subdomain has not yet been scanned in URLVoid, you will receive as output a “U” and in case of internal errors you will receive as output a “E1″, or “E2″, or “E3″ or “E4″. Other errors are described in the following list:
You used a non valid or non existent key:
Key not valid.
There is an error in the request parameters:
Request error.
For any other questions just send us an email. We recommend to follow our blog or our Twitter account to stay always updated with news and changes about this service. In future versions of the API we will create a control panel for each user and you will need to register an account to use the API service, for this reason consider this version of the API a beta release, since parameters, output formats and features will change in next version and may not be possible to use this old API key.