VerifyUp: Api | Website Uptime & Monitoring

Getting Started
With the VerifyUp API you can make it easy to get website status details as well as make it so you can basically setup your own monitoring services on your end. To get started using our API, you must first have an account with us. You can sign up here to get started. You can find your API Username and API Key on your account settings page.

Widget API Integration
Here is an example of our widget you can add to a site or admin backend on your end using a PHP cURL request

<?
$data_string = array("website"=>"example.com","size"=>"small","color1"=>"e6e4d6","color2"=>"424242","color3"=>"000000");

$ch = curl_init('https://api.verifyup.com/v1/widget?username=johnsmith&api_key=8d3839f1154750d191e792dc0b667fdd');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $data_string);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);

print $result;
?>

username = the API Username found on your settings page
api_key = the API Key uniquely assigned to your account found on the settings page
website = the website/url that is setup on your account to display for the widget
size = the size of the widget you'd like to display, options are tiny | small | medium | large
color1 = hex value for widget background
color2 = hex value for the top header and border color
color3 = hex value for the text colors

Example Output

Score API Integration
Here is an example of our score API you can implement on your end to get specific uptime details using a PHP cURL request

<?
$data_string = array( "website"=>"example.com");
$ch = curl_init('https://api.verifyup.com/v1/details?username=johnsmith&api_key=8d3839f1154750d191e792dc0b667fdd');

curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $data_string);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);

$pieces = explode("|", $result);

echo "Website: ".$pieces[0];
echo "Status: ".$pieces[1];
echo "Uptime: ".$pieces[2];
echo "Score: ".$pieces[3];
echo "Total Checks: ".$pieces[4];
echo "Total Up: ".$pieces[5];
echo "Screenshot: ".$pieces[6];
echo "Last Check: ".$pieces[7];
?>

username = the API Username found on your settings page
api_key = the API Key uniquely assigned to your account found on the settings page
website = the website/url that is setup on your account to display for the widget

Example Output

Check API Integration
Here is an example of our check API you can add to a site or admin backend on your end using a PHP cURL request

<?
$data_string = array("website"=>"verifyup.com","thumb"=>"yes","report"=>"full");                                                                                

$ch = curl_init('https://api.verifyup.com/v1/check?username=johnsmith&api_key=8d3839f1154750d191e792dc0b667fdd');                                                                     
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $data_string);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);

$pieces = explode("|", $result);

echo "Website: ".$pieces[0];
echo "Status: ".$pieces[1];
echo "Thumb: ".$pieces[2];
echo "DNS: ".$pieces[3];
echo "Size: ".$pieces[4];
echo "Score: ".$pieces[5];
echo "Requests: ".$pieces[6];
echo "Load Time: ".$pieces[7];
?>

username = the API Username found on your settings page
api_key = the API Key uniquely assigned to your account found on the settings page
website = the website/url that you'd like to get details about(does not have to be setup on your account)
thumb = whether or not to have us generate a screenshot of the website/url yes | no
report = the kind of information you'd like to receive basic | full

Example Output
verifyup.com|UP|https://api.verifyup.com/thumbs/2014/August/16/1408256190.jpg|205.196.221.71,ns1.dreamhost.com,|1361636|79|29|0.76

Error Handling
There may be times that you end up getting any one of the following error codes. Information about each one is listed below.

MAX API REQUESTS ALREADY USED THIS HOUR

You've already made more than the max number of API requests your account can make within the hour

API USERNAME AND OR API KEY INVALID

The username and or API Key you're trying to use to make a connection to our servers is invalid

UNABLE TO PROCESS REQUEST

The call you're trying to make, whether it's one or more incorrect settings, or the website is invalid

WEBSITE NOT ALLOWED

The website/url you're trying to lookup is not associated with your account, or it's no longer setup on your account to be monitored

API Limitations
Each account setup within VerifyUp is allowed a max of 30 requests each hour. Every time you call the cURL execute to https://api.verifyup.com, you use one of your requests allotted. If interested in increasing the limit on your account, special arrangements can be made by contacting our support staff.