Skip to content

Latest commit

 

History

History
1031 lines (841 loc) · 27.2 KB

stats.rst

File metadata and controls

1031 lines (841 loc) · 27.2 KB

Statistic Information

All calls to /stats/ endpoint only work with a beta API account.

TLDs Statistic

Command

GET /stats/tlds

Arguments
limit

limit result to X tlds - default 30

details

if true, result contains details

Response
tlds

list of TLD objects sort by domain_count descendering

stats

total stats object

Total Stats Object
total_domains

total count of registered domains

total_tlds

total count of tlds

TLD Object
zone

name of tld, idn encoded

zone_utf8

name of tld in native language

registry

Registry object

backend

Backend object

current_stage

name of current stage

total_domains

total count of registered domains in this TLD

registrars

list of Registrars objects (only on detailed listing)

total_registrars

total count of registrars (only on detailed listing)

Registry Object
id

id of Registry

name

name of Registry

url

url of Registry

Backend Object
id

id of Backend

name

name of Backend

url

url of Backend

Registrar Object
id

id of Registrar

iana_id

registrar IANA id

name

name of Registrar

url

homepage of Registrar

registrar_group

Registrar Group object

domain_count

total registered domains

Registrar Group Object
name

name of Registrar Group

url

homepage of Registrar Group

Example

Request

GET /stats/tlds

Response

{
    "resData": {
        "tlds": { 
            "xyz": {
                "zone": "xyz",
                "zone_utf8": "xyz",
                "registry": {
                    "name": "XYZ.COM LLC",
                    "id": "XYZCOM-LLC",
                    "info_url": "http:\/\/ntldstats.com\/registry\/XYZCOM-LLC",
                    "url": "http:\/\/nic.xyz"
                },
                "backend": {
                    "name": "CentralNic",
                    "id": "CentralNic",
                    "info_url": "http:\/\/ntldstats.com\/backend\/CentralNic",
                    "url": "http:\/\/www.centralnic.com"
                },
                "current_stage": "GA",
                "total_domains": 704262
            }
        },
        "stats": {
            "total_domains": 3097027,
            "total_tlds": 430
        }   
    },
    "code": 1000,
    "msg":"Command completed successfully",
}

Sample Link: https://beta.api.ntldstats.net/stats/tlds

TLD Statistic

Command

GET /stats/tld/<zone>

Arguments
limit

limit result of registrars

Response
tld

TLD Object

stats

total stats object

Total Stats Object
total_domains

total count of registered domains

total_tlds

total count of tlds

TLD Object
zone

name of tld, idn encoded

zone_utf8

name of tld in native language

registry

Registry object

backend

Backend object

current_stage

name of current stage

total_domains

total count of registered domains in this TLD

total_registrars

total count of registrars

registrars

list of Registrars objects

Registry Object
id

id of Registry

name

name of Registry

info_url

public nTLDStats URL to get more information about Registry

url

url of Registry

Backend Object
id

id of Backend

name

name of Backend

info_url

public nTLDStats URL to get more information about Backend

url

url of Backend

Registrar Object
id

id of Registrar

iana_id

registrar IANA id

name

name of Registrar

url

homepage of Registrar

registrar_group

Registrar Group object

domain_count

total registered domains

Registrar Group Object
name

name of Registrar Group

url

homepage of Registrar Group

Example

Request

GET /stats/tld/berlin

Response

{
    "resData": {
        "tld": {
            "zone": "berlin",
            "zone_utf8": "berlin",
            "registry": {
                "id": "dotBERLIN-GmbH-Co-KG",
                "name": "dotBERLIN GmbH & Co. KG",
                "url": "http:\/\/nic.berlin"
            },
            "backend": {
                "id": "TLDBOX-Registrydienstleistungen-GmbH",
                "name": "TLD-BOX Registrydienstleistungen GmbH",
                "url": "http:\/\/www.tld-box.at"
            },
            "total_domains": 153742,
            "total_registrars": 45,
            "registrars": [{
                "iana_id": "151",
                "name": "PSI-USA, Inc. dba Domain Robot",
                "url": "http:\/\/www.psi-usa.info",
                "registrar_group": {
                    "name": "InterNetX GmbH",
                    "url": null
                },
                "domain_count": 92056
            }],
            "current_stage": "GA"
        },
        "stats": {
            "total_domains": 3111803,
            "total_tlds": 431
        }
    },
    "code": 1000,
    "msg": "Command completed successfully"
}

Sample Link: https://beta.api.ntldstats.net/stats/tld/berlin

Registrars Statistic

Command

GET /stats/registrars

Arguments
limit

limit result to X tlds - default 30

details

if true, result contains details

Response
registrars

list of Registrar Objects

stats

total stats object

Total Stats Object
total_domains

total count of registered domains

total_tlds

total count of tlds

Registrar Object
id

id of Registrar

iana_id

registrar IANA id

name

name of Registrar

url

homepage of Registrar

registrar_group

Registrar Group object

total_domains

total registered domains

tlds

list of TLD objects (only on detailed listing)

total_tlds

total count of TLDs (only on detailed listing)

Registrar Group Object
name

name of Registrar Group

url

homepage of Registrar Group

TLD Object
zone

name of tld, idn encoded

zone_utf8

name of tld in native language

current_stage

name of current stage

domain_count

total count of registered domains in this TLD

Example

Request

GET /stats/registrars

Response

{
    "resData": {
        "stats": {
            "total_domains": 3111803,
            "total_tlds": 431
        },
        "registrars": [{
            "id": "146",
            "iana_id": "146",
            "name": "GoDaddy.com, LLC",
            "url": "http:\/\/www.godaddy.com",
            "registrar_group": {
                "name": "GoDaddy Group",
                "url": "http:\/\/godaddy.com\/"
            },
            "total_domains": 490765
        }]
    },
    "code": 1000,
    "msg": "Command completed successfully"
}

Sample Link: https://beta.api.ntldstats.net/stats/registrars

Registrar Statistic

Command

GET /stats/registrar/<iana_id>

Arguments
limit

limit result of tlds

Response
registrar

Registrar Object

stats

total stats object

Total Stats Object
total_domains

total count of registered domains

total_tlds

total count of tlds

Registrar Object
id

id of Registrar

iana_id

registrar IANA id

name

name of Registrar

url

homepage of Registrar

registrar_group

Registrar Group object

total_domains

total registered domains

total_tlds

total count of TLDs

tlds

list of TLD objects

Registrar Group Object
name

name of Registrar Group

url

homepage of Registrar Group

TLD Object
zone

name of tld, idn encoded

zone_utf8

name of tld in native language

current_stage

name of current stage

domain_count

total count of registered domains in this TLD

Example

Request

GET /stats/registrar/146

Response

{
    "resData": {
        "registrar": {
            "id": "146",
            "iana_id": "146",
            "name": "GoDaddy.com, LLC",
            "url": "http:\/\/www.godaddy.com",
            "registrar_group": {
                "name": "GoDaddy Group",
                "url": "http:\/\/godaddy.com\/"
            },
            "total_domains": 490765,
            "total_tlds": 220,
            "tlds": [{
                "zone": "guru",
                "zone_utf8": "guru",
                "domain_count": 44201,
                "current_stage": "GA"
            }]
        },
        "stats": {
            "total_domains": 3111803,
            "total_tlds": 431
        }
    },
    "code": 1000,
    "msg": "Command completed successfully"
}

Sample Link: https://beta.api.ntldstats.net/stats/registrar/146

Backends Statistic

Command

GET /stats/backends

Arguments
limit

limit result to X tlds - default 30

details

if true, result contains details

Response
backends

list of Backend Objects

stats

total stats object

Total Stats Object
total_domains

total count of registered domains

total_tlds

total count of tlds

Backend Object
id

id of Backend

name

name of Backend

url

homepage of Backend

total_domains

total registered domains

tlds

list of TLD objects (only on detailed listing)

total_tlds

total count of TLDs (only on detailed listing)

TLD Object
zone

name of tld, idn encoded

zone_utf8

name of tld in native language

current_stage

name of current stage

domain_count

total count of registered domains in this TLD

Example

Request

GET /stats/backends

Response

{
    "resData": {
        "stats": {
            "total_domains": 3111803,
            "total_tlds": 431
        },
        "backends": [{
            "id": "Donuts-Inc",
            "name": "Donuts Inc.",
            "url": "http:\/\/www.donuts.co",
            "total_domains": 1050611
        }]
    },
    "code": 1000,
    "msg": "Command completed successfully"
}

Sample Link: https://beta.api.ntldstats.net/stats/backends

Backend Statistic

Command

GET /stats/backend/<id>

Arguments
limit

limit result of tlds

Response
backend

Backend Object

stats

total stats object

Total Stats Object
total_domains

total count of registered domains

total_tlds

total count of tlds

Backend Object
id

id of Backend

name

name of Backend

url

homepage of Backend

total_domains

total registered domains

tlds

list of TLD objects

total_tlds

total count of TLDs

TLD Object
zone

name of tld, idn encoded

zone_utf8

name of tld in native language

current_stage

name of current stage

domain_count

total count of registered domains in this TLD

Example

Request

GET /stats/backend/Donuts-Inc

Response

{
    "resData": {
        "backend": {
            "id": "Donuts-Inc",
            "name": "Donuts Inc.",
            "url": "http:\/\/www.donuts.co",
            "total_domains": 1050611,
            "total_tlds": 152,
            "tlds": [{
                "zone": "guru",
                "zone_utf8": "guru",
                "domain_count": 75685,
                "current_stage": "GA"
            }]
        },
        "stats": {
            "total_domains": 3111803,
            "total_tlds": 431
        }
    },
    "code": 1000,
    "msg": "Command completed successfully"
}

Sample Link: https://beta.api.ntldstats.net/stats/backend/Donuts-Inc

Registries Statistic

Command

GET /stats/registries

Arguments
limit

limit result to X tlds - default 30

details

if true, result contains details

Response
registries

list of Registry Objects

stats

total stats object

Total Stats Object
total_domains

total count of registered domains

total_tlds

total count of tlds

Registry Object
id

id of Registry

name

name of Registry

url

homepage of Registry

total_domains

total registered domains

tlds

list of TLD objects (only on detailed listing)

total_tlds

total count of TLDs (only on detailed listing)

TLD Object
zone

name of tld, idn encoded

zone_utf8

name of tld in native language

current_stage

name of current stage

domain_count

total count of registered domains in this TLD

Example

Request

GET /stats/registries

Response

{
    "resData": {
        "stats": {
            "total_domains": 3111803,
            "total_tlds": 431
        },
        "registries": [{
            "id": "XYZCOM-LLC",
            "name": "XYZ.COM LLC",
            "url": "http:\/\/nic.xyz",
            "total_domains": 706635
        }]
    },
    "code": 1000,
    "msg": "Command completed successfully"
}

Sample Link: https://beta.api.ntldstats.net/stats/registries

Registry Statistic

Command

GET /stats/registry/<id>

Arguments
limit

limit result of tlds

Response
registry

Registry Object

stats

total stats object

Total Stats Object
total_domains

total count of registered domains

total_tlds

total count of tlds

Registry Object
id

id of Registry

name

name of Registry

url

homepage of Registry

total_domains

total registered domains

tlds

list of TLD objects

total_tlds

total count of TLDs

TLD Object
zone

name of tld, idn encoded

zone_utf8

name of tld in native language

current_stage

name of current stage

domain_count

total count of registered domains in this TLD

Example

Request

GET /stats/registry/XYZCOM-LLC

Response

{
    "resData": {
        "registry": {
            "id": "XYZCOM-LLC",
            "name": "XYZ.COM LLC",
            "url": "http:\/\/nic.xyz",
            "total_domains": 706635,
            "total_tlds": 2,
            "tlds": [{
                "zone": "xyz",
                "zone_utf8": "xyz",
                "domain_count": 706634,
                "current_stage": "GA"
            }]
        },
        "stats": {
            "total_domains": 3111803,
            "total_tlds": 431
        }
    },
    "code": 1000,
    "msg": "Command completed successfully"
}

Sample Link: https://beta.api.ntldstats.net/stats/registry/XYZCOM-LLC

Parking Statistics by TLD

Command

GET /stats/parking/tlds

Arguments

-- None

Response
stats

Global Statistic object

tlds

list of TLD objects

Global Statistic Object
total_domains

total count of registered domains

total_tlds

total count of tlds

parking_domains

total count of parking domains

no_ns

total count of domains without nameservers

parking_ns

total count of domains with parking nameservers

no_record

total count of domains without A record

parking_ip

total count of domains with parking IP

private_ip

total count of domains resolving to private IPs

parking_check

total count of domains returning parking websites

http_error

total count of domains with HTTP errors

redirect

total count of domains returning redirect code

Statistic Object
parking_domains

total count of parking domains

no_ns

total count of domains without nameservers

parking_ns

total count of domains with parking nameservers

no_record

total count of domains without A record

parking_ip

total count of domains with parking IP

private_ip

total count of domains resolving to private IPs

parking_check

total count of domains returning parking websites

http_error

total count of domains with HTTP errors

redirect

total count of domains returning redirect code

TLD Object
zone

name of tld, idn encoded

zone_utf8

name of tld in native language

domain_count

total count of registered domains in this TLD

stats

Statistic Object

Example

Request

GET /stats/parking/tlds

Response

{
    "resData": {
        "stats": {
            "total_tlds": 431,
            "total_domains": 3111803,
            "parking_domains": 2056544,
            "no_ns": 11660,
            "parking_ns": 231350,
            "no_record": 486538,
            "parking_ip": 97615,
            "private_ip": 7198,
            "parking_check": 1222183,
            "http_error": 290152,
            "redirect": 281672
        },
        "tlds": [{
            "zone": "xyz",
            "zone_utf8": "xyz",
            "total_domains": 709096,
            "stats": {
                "parking_domains": 485117,
                "no_ns": 3356,
                "parking_ns": 6015,
                "no_record": 68129,
                "parking_ip": 4329,
                "private_ip": 3496,
                "parking_check": 399792,
                "http_error": 105986,
                "redirect": 20461
            }
        }],
        "code": 1000,
        "msg":"Command completed successfully",
    }
}

Sample Link: https://beta.api.ntldstats.net/stats/parking/tlds

Parking Statistics by Registrar

Command

GET /stats/parking/registrars

Arguments

-- None

Response
stats

Global Statistic object

registrars

list of Registrar objects

Global Statistic Object
total_domains

total count of registered domains

total_tlds

total count of tlds

parking_domains

total count of parking domains

no_ns

total count of domains without nameservers

parking_ns

total count of domains with parking nameservers

no_record

total count of domains without A record

parking_ip

total count of domains with parking IP

private_ip

total count of domains resolving to private IPs

parking_check

total count of domains returning parking websites

http_error

total count of domains with HTTP errors

redirect

total count of domains returning redirect code

Statistic Object
parking_domains

total count of parking domains

no_ns

total count of domains without nameservers

parking_ns

total count of domains with parking nameservers

no_record

total count of domains without A record

parking_ip

total count of domains with parking IP

private_ip

total count of domains resolving to private IPs

parking_check

total count of domains returning parking websites

http_error

total count of domains with HTTP errors

redirect

total count of domains returning redirect code

Registrar Object
id

id of Registrar

iana_id

registrar IANA id

name

name of Registrar

url

homepage of Registrar

registrar_group

Registrar Group object

total_domains

total registered domains

stats

Statistic object

Registrar Group Object
name

name of Registrar Group

url

homepage of Registrar Group

Example

Request

GET /stats/parking/registrars

Response

{
    "resData": {
        "stats": {
            "total_tlds": 431,
            "total_domains": 3111803,
            "parking_domains": 2056544,
            "no_ns": 11660,
            "parking_ns": 231350,
            "no_record": 486538,
            "parking_ip": 97615,
            "private_ip": 7198,
            "parking_check": 1222183,
            "http_error": 290152,
            "redirect": 281672
        },
        "registrars": [{
            "total_domains": 413708,
            "id": "2-Network-Solutions-LLC",
            "iana_id": "2",
            "name": "Network Solutions, LLC",
            "registrar_group": {
                "name": "Web.com",
                "url": "https:\/\/www.web.com\/"
            },
            "stats": {
                "parking_domains": 397980,
                "no_ns": 37,
                "parking_ns": 145,
                "no_record": 16088,
                "parking_ip": 6,
                "private_ip": 28,
                "parking_check": 381676,
                "http_error": 11376,
                "redirect": 2953
            }
        }],
        "code": 1000,
        "msg":"Command completed successfully",
    }
}

Sample Link: https://beta.api.ntldstats.net/stats/parking/registrars

Fraud Statistics

Command

GET /stats/fraud

Arguments
limit

limit result to X items - default 1000

details

if true, result contains items list

no_nameserver

default true, skip entries without nameservers

no_dns_hold

default true, skip entries with dns hold flag

has_dns_record

default true, skip entries without dns records

no_resolving_ns

default true, skip entries with "non-resolver-nameserver"

tld

limit result for specific TLD

Response
stats

Global Statistic object

lists

list of Blacklist List objects

tlds

list of TLD Statistic objecs

items

list of Blacklist Entry objects (optional)

Global Statistic Object
total_domains

total count of registered domains

total_tlds

total count of tlds

total_fraud_domains

total count of suspicious domains

total_dnsbl_domains

total count of domains in dnsbl lists

total_dnsbl_lists

total count of dnsbl lists

total_gsb_domains

total count of domains in gsb lists

total_gsb_lists

total count of gsb lists

TLD Statistic Object
count

total count ot suspicious domains

zone

name of tld, idn encoded

zone_utf8

name of tld in native language

Blacklist List Object
id

id of blacklist item

name

name of blacklist

name_short

shorter version of name

url

url of blacklist

dnshost

blacklist hostname (optional)

total_active_records

total count of suspicious domains (optional)

Blacklist Entry Object
created

date entry added to database

domain_name

name of domain, idn encoded

domain_name_utf8

name of domain in native language

tld

name of tld, idn encoded

tld_utf8

name of tld in nativ language

country

iso country code owner contact

lists

list of Blacklist List Object

additional_info

additional infos returned by blacklist

additional_link

additional link returned by blacklist

has_nameserver

domain has linked nameservers

has_dns_hold

dns hold flag is set for domain

has_dns_record

domain nameserver answered with valid A record

scan

Scan Object

Scan Object
date

date of scan

perm_url

url of scan result

infected

count of positive scan results

total

total count of scanners

results

list of Scan Result Object

Scan Result Object
name

name of product

manufacturer

name of manufacturer

url

url of product/manufacturer

Example

Request

GET /stats/fraud

Response

{
    "resData": {
        "stats": {
            "total_domains": 3631218,
            "total_tlds": 436,
            "total_fraud_domains": 1696,
            "total_dnsbl_domains": 2,
            "total_dnsbl_lists": 29,
            "total_gsb_domains": 2,
            "total_gsb_lists": 4
        },
        "lists": {
            "dnsbl": [{
                "id": 328,
                "name": "abuse.ch ZeuS Tracker Domain",
                "name_short": "abuse.ch (ZeuS)",
                "url": "https:\/\/zeustracker.abuse.ch\/",
                "dnshost": "uribl.zeustracker.abuse.ch",
                "total_active_records": 0
            }],
            "gsb": [{
                "id": 1,
                "name": "Google Safe Browsing Phishing",
                "name_short": "Phishing",
                "url": "https:\/\/developers.google.com\/safe-browsing\/safebrowsing_faq",
                "total_active_records": 15
            }]
        },
        "tlds": [{
            "count": 806,
            "zone": "link",
            "zone_utf8": "link"
        }],
        "items": {
            "dnsbl": [{
                "created": "2014-12-27T08:02:33Z",
                "additional_info": "",
                "domain_name": "kino",
                "tld": "menu",
                "country": "CA",
                "domain_name_utf8": "kino",
                "tld_utf8": "menu",
                "lists": [{
                    "name": "Spamhaus DBL Domain Block List",
                    "url": "http:\/\/www.spamhaus.org\/dbl\/",
                    "id": 575
                }],
                "scan": {
                    "date": "2015-02-13T13:34:32Z",
                    "perm_url": "https:\/\/www.virustotal.com\/url\/f67ff04ccb199e86bcf6804df47a931986298fd59bda5baf39bdb7b3bee21b36\/analysis\/1423834472\/",
                    "infected": "0",
                    "total": "62",
                    "results": []
                }
                "additional_link": "http:\/\/www.spamhaus.org\/query\/dbl?domain=kino.menu",
                "has_nameserver": true,
                "has_dns_hold": false,
                "has_dns_record": true
            }],
            "gsb": [{
                "created": "2014-12-28T04:21:10Z",
                "additional_info": "",
                "domain_name": "starradio",
                "tld": "london",
                "country": "GB",
                "domain_name_utf8": "starradio",
                "tld_utf8": "london",
                "lists": [{
                    "name": "Google Safe Browsing Malware",
                    "url": "https:\/\/developers.google.com\/safe-browsing\/safebrowsing_faq",
                    "id": 2
                }],
                "scan": {
                    "date": "2015-02-13T11:31:14Z",
                    "perm_url": "https:\/\/www.virustotal.com\/url\/c3b1649f5cf4723ce80199e2a1673a63c87df9992a06c66689b8a26e5a9302cb\/analysis\/1423827074\/",
                    "infected": "1",
                    "total": "62",
                    "results": [{
                        "name": "Google Safebrowsing",
                        "manufacturer": "Google",
                        "url": "http:\/\/code.google.com\/apis\/safebrowsing\/"
                    }]
                }
                "additional_link": "https:\/\/safebrowsing.clients.google.com\/safebrowsing\/diagnostic?site=starradio.london",
                "has_nameserver": true,
                "has_dns_hold": false,
                "has_dns_record": true
            }]
        }
    },
    "code": 1000,
    "msg": "Command completed successfully"
}

Sample Link: https://beta.api.ntldstats.net/stats/fraud