DMOZ Inclusion Checker API Documentation

General Information

API Endpoint

Use POST to send the data to servya.

Input Variables

Output Variables

Output Examples

To start testing your implementation and the provided code examples you will first need to acquire an API key.

When you have your API key you will want to visit the documentation for the individual tools to get the API endpoints, inputs, outputs and examples.

We have code examples in lots of popular languages but if you need some help in a different language you can get in touch for some advice.

The API uses simple HTTP post requests and JSON to keep the process of interacting with the API and handling the data returned as simple as possible.

See the list of tools on this page for a direct link to the documentation for the tools.

We have code examples for 6 major programming languages below to aid the integration with your platform.

Integrating Servya into a supported tool is really simple!

You will first need to get an API key for Servya and then copy it into your software.

From our side, that is all you need to do. Your software should now be able to use the data from our tools.

Below you'll find code examples in various programming languages. These examples demonstrate how to interact with our API, making it easier for you to integrate our services into your applications. Simply click on the headers to view the code in your preferred language and see how you can quickly get started.

<?php
//Input Variables
$api_key = "!! THIS IS YOUR API KEY !!"; 
$job_input = "example.com";

$apiUrl = "https://api.servya.com/process_job.php";

$data = array(
    'apikey' => $api_key,
    'job_type' => 'dmoz_check',
    'job_input' => $job_input
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
if ($response === FALSE) {
    die('Error: ' . curl_error($ch));
}
curl_close($ch);

$data = json_decode($response, true);

// Output API response
print_r($response);
?>

using System;
using System.Net.Http;
using System.Collections.Generic;
using System.Threading.Tasks;
using Newtonsoft.Json;

class Program
{
    private static readonly HttpClient client = new HttpClient();

    static async Task Main()
    {
		// Input Variables
		string api_key = "!! THIS IS YOUR API KEY !!";
		string domain = "example.com";


		var values = new Dictionary
		{
			{ "apikey", api_key },
			{ "job_type", "dmoz_check" },
			{ "job_input", domain }
		};

		var content = new FormUrlEncodedContent(values);
		var response = await client.PostAsync("https://api.servya.com/process_job.php", content);
		var responseString = await response.Content.ReadAsStringAsync();

		dynamic data = Newtonsoft.Json.JsonConvert.DeserializeObject(responseString);

		// Output response data to console
		Console.WriteLine(data);
    }
}

import requests

# Fill in your API Key from the website
api_key = '!! THIS IS WHERE YOU PUT YOUR API KEY !!'
# This is the domain to check
domain = 'example.com'

api_url = 'https://api.servya.com/process_job.php'
data = {
    'apikey': api_key,
    'job_type': 'dmoz_check',
    'job_input': domain
}

response = requests.post(api_url, data=data)
data = response.json()

# output the data
print(data)

const https = require('https');
const querystring = require('querystring');

const postData = querystring.stringify({
  'apikey': 'your_api_key',
  'job_type': 'dmoz_check',
  'job_input': 'example.com'
});

const options = {
  hostname: 'api.servya.com',
  port: 443,
  path: '/process_job.php',
  method: 'POST',
  headers: {
    'Content-Type': 'application/x-www-form-urlencoded',
    'Content-Length': postData.length
  }
};

const req = https.request(options, (res) => {
  let data = '';

  res.on('data', (chunk) => {
    data += chunk;
  });

  res.on('end', () => {
    const parsedData = JSON.parse(data);
    console.log(parsedData);
  });
});

req.on('error', (e) => {
  console.error(`Problem with request: ${e.message}`);
});

req.write(postData);
req.end();

require 'net/http'
require 'uri'
require 'json'

uri = URI.parse("https://api.servya.com/process_job.php")
request = Net::HTTP::Post.new(uri)
request.set_form_data(
  "apikey" => "your_api_key",
  "job_type" => "dmoz_check",
  "job_input" => "example.com"
)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

data = JSON.parse(response.body)
puts data

package main

import (
	"bytes"
	"fmt"
	"net/http"
	"net/url"
	"strings"
)

func main() {
	apiUrl := "https://api.servya.com/process_job.php"
	data := url.Values{}
	data.Set("apikey", "!! THIS IS YOUR API KEY !!")
	data.Set("job_type", "dmoz_check")
	data.Set("job_input", "example.com")

	req, err := http.NewRequest("POST", apiUrl, strings.NewReader(data.Encode()))
	if err != nil {
		fmt.Println("Error creating request:", err)
		return
	}
	req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
	req.Header.Set("Content-Length", fmt.Sprint(len(data.Encode())))

	client := &http.Client{}
	response, err := client.Do(req)
	if err != nil {
		fmt.Println("Error making request:", err)
		return
	}
	defer response.Body.Close()

	buf := new(bytes.Buffer)
	buf.ReadFrom(response.Body)
	fmt.Println("Response:", buf.String())
}

Get guidance on each specific API enabled tool and function here:

• Full API Documentation
• Check Balance
• Whois Lookup API docs
• Domain Availability API docs
• Dns Lookup API docs
• Domdetailer API docs
• Domain Age API docs
• Backlink Download API docs
• Email Verifier API docs
• Purchasable Link Search API docs