Connect with the most recent version of the Free Valuator REST API to get domain valuations and other rankings and resources.

Connecting to the API

To connect with the API you need a premium subscription, your username and your API key.

Communicating with the API

API Url: https://api.freevaluator.com/

To authenticate and communicate with the API, you need to use the following GET parameters.

todoWith the todo parameter you tell the api what to do. The following options are available: valuator, whois, facebookworth, twitterworth, reverseip
format (optional)With the format parameter you tell the api in wich format to output the data. The following options are available: json, xml
usernameFill in your username.
api_keyFill in your API key.
domainFill in the domain wich you would like to look up.

Every Premium user receives 5000 API calls each month. Do you need more API calls? Order an extended API Subscription.

Example GET request

Underneath an example of a GET request to the API. You need to change the username and API key in this example to get it to work. You can also download the PHP examples on Github or use the PHP Class for the Free Valuator API.

API Url: https://api.freevaluator.com/?todo=valuator&format=json&username=YOUR_USERNAME&api_key=YOUR_APIKEY&domain=example.com

API Return data

The API returns data as XML or JSON. For every request it will give you the following returns:

    successThis will return 1 for a successfull request or 0 for an error.
    errorThis will contain an error message if there is an error.
    domainThe domain for wich the lookup is.
    dataThe result data.

PHP Example

<?php
/**
 *  Example API call
 *  Free Valuator
 */

// Fill in your API Key
$api_key = 'your api key here';

// Fill in your username
$username = 'your username here';

// Fill in the domain to check
$domain = 'example.com';

// Set up the curl resource
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.freevaluator.com/?todo=valuator&format=json&username=$username&api_key=$api_key&domain=$domain");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

// Execute the request
$output = curl_exec($ch);

// Output the result data
$result = json_decode($output);
print_r($result);

// Close curl resource to free up system resources
curl_close($ch);
?>