SiteSleuth API Documentation

The SiteSleuth API is free to use, but you must create an account to get an API key. The API gives you full access to our search tool and to check the number of credits you have left. Each search costs one credit.

Rate Limits

Credits

There are two types of credits—expirable credits and non-expirable credits. Exirable credits are the credits you get every month. These do not carry over month to month. Non-expirable credits are purchased. These credits do carry over month to month.

We always use your expirable credits before the non-expirable credits.

Traffic Bursts

In addition to your overall credit limit, there is a limit of 60 requests per minute. This is to prevent a flood of traffic from slowing down the service for other users.

If you exceed either rate limit, the API returns a 429 Too Many Requests error.

API Key

Go to your settings to get an API key. Once you have an API token, you can access the API by passing the token in the api_token query string parameter when making requests.

API Endpoints

There are two API endpoints: one to search and one to see credits remaining.

Search Endpoint

Use the following URL to search:

GET https://www.sitesleuth.io/api/v1/search/example.com?api_token=YOUR_API_KEY

Replace YOUR_API_KEY with your own API key. Click here to get an API Key.

Replace example.com with the value you want to search. The value can be:

  • Domain Name (example.com)
  • Host (www.example.com)
  • Google Analytics Token (UA-12345678)
  • Adsense Token (ca-pub-1234567890123456)
  • Stripe Public Key (pk_live_BQokikJOvBiI2HlWgH4olfQ2)

Results from this API look like this:

GET https://www.sitesleuth.io/api/v1/search/clearwebstats.com?api_token=YOUR_API_KEY
{
	"value": "clearwebstats.com",
	"type": "domain",
	"results": [
		{
			"urls": [
				"http://madri.olsztyn.pl.clearwebstats.com/"
			],
			"print": "UA-9405310",
			"host": "madri.olsztyn.pl.clearwebstats.com",
			"domain": "clearwebstats.com",
			"host_results": 2,
			"domain_results": 343042,
			"domain_hosts": 230468,
			"print_hosts": 237391,
			"print_domains": 10
		},
		{
			"urls": [
				"https://yeezyboost350.net.clearwebstats.com/"
			],
			"print": "UA-9405310",
			"host": "yeezyboost350.net.clearwebstats.com",
			"domain": "clearwebstats.com",
			"host_results": 1,
			"domain_results": 343042,
			"domain_hosts": 230468,
			"print_hosts": 237391,
			"print_domains": 10
		},
		{
			"urls": [
				"http://viniciusdemoraes.com.br.clearwebstats.com/"
			],
			"print": "UA-9405310",
			"host": "viniciusdemoraes.com.br.clearwebstats.com",
			"domain": "clearwebstats.com",
			"host_results": 3,
			"domain_results": 343042,
			"domain_hosts": 230468,
			"print_hosts": 237391,
			"print_domains": 10
		},
		{
			"urls": [
				"https://ilogic.com.clearwebstats.com/"
			],
			"print": "UA-9405310",
			"host": "ilogic.com.clearwebstats.com",
			"domain": "clearwebstats.com",
			"host_results": 2,
			"domain_results": 343042,
			"domain_hosts": 230468,
			"print_hosts": 237391,
			"print_domains": 10
		},
		{
			"urls": [
				"https://portailqualiteprix.com.clearwebstats.com/"
			],
			"print": "UA-9405310",
			"host": "portailqualiteprix.com.clearwebstats.com",
			"domain": "clearwebstats.com",
			"host_results": 1,
			"domain_results": 343042,
			"domain_hosts": 230468,
			"print_hosts": 237391,
			"print_domains": 10
		},
		{
			"urls": [
				"https://notmamcard.com.clearwebstats.com/"
			],
			"print": "UA-9405310",
			"host": "notmamcard.com.clearwebstats.com",
			"domain": "clearwebstats.com",
			"host_results": 2,
			"domain_results": 343042,
			"domain_hosts": 230468,
			"print_hosts": 237391,
			"print_domains": 10
		},
		{
			"urls": [
				"https://dumbclothing.com.clearwebstats.com/"
			],
			"print": "UA-5763411",
			"host": "dumbclothing.com.clearwebstats.com",
			"domain": "clearwebstats.com",
			"host_results": 2,
			"domain_results": 343042,
			"domain_hosts": 230468,
			"print_hosts": 3,
			"print_domains": 2
		},
		{
			"urls": [
				"https://instestate.com.clearwebstats.com/"
			],
			"print": "ca-pub-5085525795575957",
			"host": "instestate.com.clearwebstats.com",
			"domain": "clearwebstats.com",
			"host_results": 2,
			"domain_results": 343042,
			"domain_hosts": 230468,
			"print_hosts": 69610,
			"print_domains": 3
		},
		{
			"urls": [
				"https://cascadiasys.com.clearwebstats.com/"
			],
			"print": "UA-77818112",
			"host": "cascadiasys.com.clearwebstats.com",
			"domain": "clearwebstats.com",
			"host_results": 2,
			"domain_results": 343042,
			"domain_hosts": 230468,
			"print_hosts": 19,
			"print_domains": 18
		},
		{
			"urls": [
				"https://doiydesign.com.clearwebstats.com/"
			],
			"print": "UA-27450235",
			"host": "doiydesign.com.clearwebstats.com",
			"domain": "clearwebstats.com",
			"host_results": 3,
			"domain_results": 343042,
			"domain_hosts": 230468,
			"print_hosts": 1,
			"print_domains": 1
		},
		{
			"urls": [
				"http://cnwfh.loan.clearwebstats.com/"
			],
			"print": "UA-9405310",
			"host": "cnwfh.loan.clearwebstats.com",
			"domain": "clearwebstats.com",
			"host_results": 1,
			"domain_results": 343042,
			"domain_hosts": 230468,
			"print_hosts": 237391,
			"print_domains": 10
		},
		{
			"urls": [
				"http://dronedealzone.com.clearwebstats.com/"
			],
			"print": "UA-9405310",
			"host": "dronedealzone.com.clearwebstats.com",
			"domain": "clearwebstats.com",
			"host_results": 1,
			"domain_results": 343042,
			"domain_hosts": 230468,
			"print_hosts": 237391,
			"print_domains": 10
		},
		{
			"urls": [
				"https://lolita-home.net.clearwebstats.com/"
			],
			"print": "UA-9405310",
			"host": "lolita-home.net.clearwebstats.com",
			"domain": "clearwebstats.com",
			"host_results": 1,
			"domain_results": 343042,
			"domain_hosts": 230468,
			"print_hosts": 237391,
			"print_domains": 10
		},
		{
			"urls": [
				"https://empacayexplora.com.clearwebstats.com/"
			],
			"print": "UA-9405310",
			"host": "empacayexplora.com.clearwebstats.com",
			"domain": "clearwebstats.com",
			"host_results": 1,
			"domain_results": 343042,
			"domain_hosts": 230468,
			"print_hosts": 237391,
			"print_domains": 10
		},
		{
			"urls": [
				"https://kellyathleticsandfitness.org.clearwebstats.com/"
			],
			"print": "UA-9405310",
			"host": "kellyathleticsandfitness.org.clearwebstats.com",
			"domain": "clearwebstats.com",
			"host_results": 1,
			"domain_results": 343042,
			"domain_hosts": 230468,
			"print_hosts": 237391,
			"print_domains": 10
		},
		{
			"urls": [
				"https://vidgreat.com.clearwebstats.com/"
			],
			"print": "UA-9405310",
			"host": "vidgreat.com.clearwebstats.com",
			"domain": "clearwebstats.com",
			"host_results": 2,
			"domain_results": 343042,
			"domain_hosts": 230468,
			"print_hosts": 237391,
			"print_domains": 10
		},
		{
			"urls": [
				"https://fatfreedomfitness.com.clearwebstats.com/"
			],
			"print": "UA-7117339",
			"host": "fatfreedomfitness.com.clearwebstats.com",
			"domain": "clearwebstats.com",
			"host_results": 2,
			"domain_results": 343042,
			"domain_hosts": 230468,
			"print_hosts": 2709,
			"print_domains": 111
		},
		{
			"urls": [
				"http://iluminaskin.com.br.clearwebstats.com/"
			],
			"print": "UA-9405310",
			"host": "iluminaskin.com.br.clearwebstats.com",
			"domain": "clearwebstats.com",
			"host_results": 1,
			"domain_results": 343042,
			"domain_hosts": 230468,
			"print_hosts": 237391,
			"print_domains": 10
		},
		{
			"urls": [
				"http://boozyhues.com.clearwebstats.com/"
			],
			"print": "UA-9405310",
			"host": "boozyhues.com.clearwebstats.com",
			"domain": "clearwebstats.com",
			"host_results": 1,
			"domain_results": 343042,
			"domain_hosts": 230468,
			"print_hosts": 237391,
			"print_domains": 10
		},
		{
			"urls": [
				"https://shiloh4square.org.clearwebstats.com/"
			],
			"print": "UA-9405310",
			"host": "shiloh4square.org.clearwebstats.com",
			"domain": "clearwebstats.com",
			"host_results": 2,
			"domain_results": 343042,
			"domain_hosts": 230468,
			"print_hosts": 237391,
			"print_domains": 10
		}
	],
	"last_evaluated_key": {
		"print": "UA-9405310",
		"host": "shiloh4square.org.clearwebstats.com",
		"domain": "clearwebstats.com"
	},
	"total": 343042,
	"per_page": 20
}

Pagination

Only 20 results are returned per page. In order to page through results, you must pass the last result received in a query string parameter called exclusive_start_key. This is a somewhat complicated why to do pagination. You can read more about why this is necessary here.

GET https://www.sitesleuth.io/api/v1/search/clearwebstats.com?api_token=YOUR_API_KEY&exclusive_start_key={"print":"UA-9405310","host":"shiloh4square.org.clearwebstats.com","domain":"clearwebstats.com"}
Note: Each page of search results costs one search credit.

Credits Endpoint

This endpoint lets you check how many credits you have remaining. It returns the sum of your exirable tokens an non-expirable tokes.

GET https://www.sitesleuth.io/api/v1/credits?api_token=YOUR_API_KEY
Results:
98

API DocsLoginRegisterTwitter
Copyright 2018 © SiteSleuth.io