Registrar Data Download Documentation

JSON

Download this sample

Note: this sample data file contains data for only a small number of registrars (specifically: Namecheap, 1&1, NameSilo). The actual data file contains all registrars listed on the site.

{
    "data": {
        "namecheap": {
            "name": "Namecheap",
            "icann_accredited": true,
            "payment_methods": [
                "bitcoin",
                "cc",
                "paypal",
                "dwolla"
            ],
            "free_features": {
                "dns": {
                    "count": null,
                    "duration": null
                },
                "whois_privacy": {
                    "count": null,
                    "duration": 365
                },
                "email_forward": {
                    "count": null,
                    "duration": null
                }
            },
            "tlds": {
                "best": {
                    "price": {
                        "register": 18,
                        "renewal": 25,
                        "transfer": 1,
                        "restore": 336
                    },
                    "three_year_value": 4
                },
                "total": 368
            }
        },
        "1and1": {
            "name": "1&1",
            "icann_accredited": true,
            "payment_methods": [
                "cc",
                "paypal"
            ],
            "free_features": {
                "dns": {
                    "count": null,
                    "duration": null
                },
                "email_forward": {
                    "count": null,
                    "duration": null
                },
                "email_account": {
                    "count": 1,
                    "duration": null
                },
                "whois_privacy": {
                    "count": null,
                    "duration": null
                }
            },
            "tlds": {
                "best": {
                    "price": {
                        "register": 155,
                        "renewal": 1,
                        "transfer": 218,
                        "restore": 0
                    },
                    "three_year_value": 9
                },
                "total": 373
            }
        },
        "namesilo": {
            "name": "NameSilo",
            "icann_accredited": true,
            "payment_methods": [
                "bitcoin",
                "paypal",
                "skrill",
                "googlewallet",
                "cc"
            ],
            "free_features": {
                "dns": {
                    "count": null,
                    "duration": null
                },
                "email_forward": {
                    "count": null,
                    "duration": null
                },
                "whois_privacy": {
                    "count": null,
                    "duration": null
                }
            },
            "tlds": {
                "best": {
                    "price": {
                        "register": 10,
                        "renewal": 16,
                        "transfer": 18,
                        "restore": 0
                    },
                    "three_year_value": 8
                },
                "total": 259
            }
        }
    },
    "diff": []
}

Description

This download is a JSON file containing registrar statistics, TLD counts, free features, payment methods, etc. Basically everything that's displayed on the Registrars page.

The tables below describe the fields contained in the data file. The Field column is the path of the field in dot notation. The Type column is the data type of the field's value.

data

The top-level data object of the JSON file contains the collection of registrar objects, keyed by a registrar ID. Below are the fields of each registrar object.

Note: for easier integration, it is recommended to simply sync the top-level data object to your own database on every download.

Field Type Description
name string The display name of the registrar or provider.
icann_accredited boolean true if the registrar is ICANN accredited, otherwise false.
payment_methods array of strings Array of strings representing the payment methods the registrar accepts.

cc - credit cards
paypal - Paypal
dwolla - Dwolla
googlewallet - Google Wallet
bitcoin - Bitcoin
banktransfer - bank transfer/wire
topcoin - Topcoin
skrill - Skrill
moneyorder - money order
check - check
cashinperson - cashinperson
alipay - Alipay
webmoney - WebMoney
payza - Payza
cashinmail - cash in mail
maestro - Maestro
worldpay - Worldpay
free_features object A collection of objects representing the free features the registrar offers with domain ownership. Note that features can vary depending on the TLD (for example, WHOIS privacy may not be available for certain TLDs). Object includes the quantity and duration of each feature. Each object is keyed with a free feature ID:

dns - free DNS service.
whois_privacy - WHOIS privacy service.
email_account - free email account(s).
email_forward - free email forwarding.
ssl_cert - free basic SSL certificate(s).

Example free feature objects:

{
    "email_account": {
        "count": 5,
        "duration": null
    },
    "ssl_cert": {
        "count": null,
        "duration": 365
    }
}
free_features[feature].count number|null The quantity of the feature the registrar offers for free. This value will be null if it does not apply.
free_features[feature].duration number|null The number of days the feature is offered for free by the registrar. If the duration = 365, then feature is offered for free for 1 year. This value will be null if it does not apply.
tlds.best.price.register number Total count of TLDs offered by the registrar at the cheapest registration price.
tlds.best.price.renewal number Total count of TLDs offered by the registrar with the cheapest renewal price.
tlds.best.price.transfer number Total count of TLDs offered by the registrar with the cheapest transfer price.
tlds.best.three_year_value number Total count of TLDs offered by the registrar that are considered to have the best 3 year value in comparison to other registrars offering the same TLD.
tlds.total number Total number of TLDs offered by the registrar.

diff

The top-level diff object of the JSON file contains the differences of this data file compared to your previously downloaded data file. If the data file has changed since your last download, the diff object will be an array of diff objects describing the paths of the data that changed, the type of change, and the prior and current values. If the data has not changed, the diff object will be an empty array. The table below describes the fields contained in each diff object.

Note: the diff is provided for informational purposes only. For easier integration, it is recommended to simply sync the top-level data object to your own database, rather than trying to update specific fields according to the diff.

Field Type Description
path array of strings The path of the changed field in the data object, where each element is a string subpath. The array can be joined with a a '.' character to get the path as a string in dot notation.
change string A single character representing the type of change:
N - indicates a newly added field/property
D - indicates a field/property was deleted
E - indicates a field/property was edited
A - indicates a change occurred within an array
was mixed The previous value of the path.
is mixed The current value of the path.
index number When the change occurred to an array (change = 'A'), indicates the numeric array index where the change occurred. Not present when the change did not occur to an array.
item mixed When the change occurred to an array (change = 'A'), contains a nested diff object indicating the change that occurred at the array index. Not present when the change did not occur to an array.

Registrars

A list of registrar ID's and the registrars they represent.

ID Registrar
101domain 101domain
1and1 1&1
above.com Above.com
alpnames AlpNames
amazonroute53 Amazon Route 53
amenworld AmenWorld
bigrock BigRock
crazydomains Crazy Domains
directnic Directnic
domain.com Domain.com
domainmonster Domainmonster
dot.al Dot.AL
dotology Dotology
dotster Dotster
dreamhost DreamHost
dyn Dyn
dynadot Dynadot
epik Epik
espace2001 Espace 2001
eurodns EuroDNS
gandi Gandi.net
godaddy GoDaddy
googledomains Google Domains
hexonet Hexonet
hostgator HostGator
hover Hover
instra Instra
internet.bs Internet.bs
istanco ISTanCo
iwantmyname iwantmyname
marcaria Marcaria.com
mindsandmachines Minds + Machines
name.com Name.com
namecheap Namecheap
namesilo NameSilo
netcetera Netcetera
netfirms Netfirms
netim Netim
networksolutions Network Solutions
nfsn NearlyFreeSpeech
onlydomains OnlyDomains
porkbun Porkbun
regtons Regtons
uniregistry Uniregistry
uniteddomains United Domains
web4africa Web4Africa
webnames.ca Webnames.ca
whois.com Whois.com