Top Level Domains (TLD) Distribution

The SerpstatBacklinksProcedure.getDistributionTLD method returns information about the number of domain backlinks that belong to a specific top-level domain zone. The data set is similar to the Referring TLD map in the Overview report.

Use case: With the SerpstatBacklinksProcedure.getDistributionTLD method, determine from what regions users can get to the site based on incoming links.

General request parameters and instructions for using Serpstat API

Request parameters
Parameter	Description	Type	Required	Default value	Value options
id	A request id: the response contains the same id. Enter any number (number) or text (string) value	int/string	yes		Text or number value. For example: 1, test
method	API method name	string	yes		SerpstatBacklinksProcedure.getDistributionTLD
params	The object with parameters {...}, it lists all the following parameters and arrays [...]		yes
query	Domain of the analyzed site. Specify the domain without http / https and «/»	string	yes		The text value of the domain being analyzed. For example: facebook.com
lang	Language of country_name in response	string	no	"en"	"ru","en","uk","de","se"
searchType	Search modes for analysis	string	no	domain_with_subdomains	domain - only domain (site.com) domain_with_subdomains - domain with subdomains (subdomain.site.com)

Response parameters
Parameter	Description
id	Response id corresponds the request id
result	Object, which contains the answer
data	Array which contains objects with data
tld	Top-level domain zone
country_name	Country name
country_code	Country code
percentage	Percentage of the number of domains from the response object to the total number of domains
domains	Number of referring domains
summary_info	Contains an object with data
tld_count	Number of top-level domain zones
domains_count	Total number of domains
biggest_tld_percentage	Percentage of domain zone links with the most links to the total number of links
sort	What data are sorted by
order	Order: * asc - in the ascending order * desc - in the descending order
left_lines	Left credits of API lines for your pricing plan

1 API credit is spent per 1 request.

Example

Request data:

{
 "id": "1",
 "method": "SerpstatBacklinksProcedure.getDistributionTLD",
 "params": {
     "query" : "facebook.com",
	 "lang" : "en",
     "searchType": "domain_with_subdomains"
  }
}

Response data:

    "id": "1",
    "result": {
        "data": [
            {
                "tld": ".com",
                "country_name": "",
                "country_code": "",
                "percentage": 59.200000000000003,
                "domains": 23670391
            },
            {
                "tld": ".org",
                "country_name": "",
                "country_code": "",
                "percentage": 4,
                "domains": 1581030
            },
            {
                "tld": ".uk",
                "country_name": "United Kingdom",
                "country_code": "gb",
                "percentage": 3.1000000000000001,
                "domains": 1241427
            },
            {
                "tld": ".de",
                "country_name": "Germany",
                "country_code": "de",
                "percentage": 3.1000000000000001,
                "domains": 1219485
            },
            {
                "tld": ".net",
                "country_name": "",
                "country_code": "",
                "percentage": 3,
                "domains": 1214551
            },
            {
                "tld": ".ru",
                "country_name": "Russia",
                "country_code": "ru",
                "percentage": 1.6000000000000001,
                "domains": 635591
            },
            {
                "tld": ".br",
                "country_name": "Brazil",
                "country_code": "br",
                "percentage": 1.3999999999999999,
                "domains": 556360
            },
            {
                "tld": ".nl",
                "country_name": "Netherlands",
                "country_code": "nl",
                "percentage": 1.3999999999999999,
                "domains": 569174
            },
            {
                "tld": ".fr",
                "country_name": "France",
                "country_code": "fr",
                "percentage": 1.3,
                "domains": 535516
            },
            {
                "tld": ".pl",
                "country_name": "Poland",
                "country_code": "pl",
                "percentage": 1.1000000000000001,
                "domains": 437383
            }
        ],
        "summary_info": {
            "tld_count": 1203,
            "domains_count": 39957263,
            "biggest_tld_percentage": 59.200000000000003,
            "sort": "percentage",
            "order": "desc",
            "left_lines": 988477
        }
    }
}