Daily Counts

stats/daily/counts

This call returns the total number of registrations for each gTLD, as well as daily registration deltas. Additional data can be returned with a Premium Subscription.

Parameters

limit (optional)

The maximum number of gTLDs to return. Default value is 0, meaning no limit.

order (optional)

The order in which results are returned. Possible values are:

  • domain_count (default) Results ordered by descending total domain count
  • net_zone_change Results ordered by descending daily registration delta

Response

The dictionary returned contains the following keys:

  • total_tlds Total number of gTLDs. The actual number of results returned may be less if the limit parameter was used
  • timestamp UTC date of most recent update in the results; some results may be older than this
  • tlds An array containing a dictionary for each gTLD

Each dictionary in the tlds array has the following keys:

  • tld_name gTLD name or xn-- punycode
  • domain_count Total number of registrations for this TLD
  • net_zone_change Net change in the number of registrations since the TLD zone was last analysed (typically a daily delta). Calculated as (new_to_zone + back_in_zone) - removed_from_zone. Related keys:
    • new_to_zone Number of new registrations added to the zone
    • removed_from_zone Number of registrations removed from the zone
    • back_in_zone Number of registrations reinstated into the zone
  • tld_timestamp Date and time the counts for this TLD were last updated
  • full_info_url Link to dedicated namestat.org page for this TLD

Additional keys are returned with a Premium Subscription

Example

Request

{
  "access_token": "<your access token>",
  "limit": 100,
  "order": "net_zone_change"
}

Response

{
  "total_tlds": 511,
  "timestamp": "2015-03-10 07:00:02",
  "tlds": [
    {
      "full_info_url": "http://namestat.org/wang",
      "net_zone_change": 1505,
      "domain_count": 128881,
      "tld_name": "wang",
      "timestamp": "2015-03-10 07:00:02"
    },
    ...
  ]
}

Premium Subscription

Additional datasets can be returned with a premium subscription. At the moment Daily Registrar details can be obtained however other datasets will be available shortly.

- Parameters

include_registrars (optional)

Include the Daily registrar breakdown for each TLD. Possible values are:

  • yes (default) All Registrar information is returned for each TLD
  • no No Registrar information is returned.

- Response

Additional keys are returned in the tlds array:

  • registrars An array containing containing a dictionary for each registrar

Each dictionary in the registrars array has the following keys:

  • iana_id IANA id of this registrar
  • registrar_name Registrar name
  • new_to_zone Number of new registrations for this registrar

- Example

Request

{
  "access_token": "<your access token>",
  "limit": 100,
  "order": "net_zone_change"
}

Response

{
  "total_tlds": 511,
  "timestamp": "2015-03-10 07:00:02",
  "tlds": [
    {
      "full_info_url": "http://namestat.org/wang",
      "net_zone_change": 1505,
      "domain_count": 128881,
      "tld_name": "wang",
      "tld_timestamp": "2015-03-10 07:00:02",
      "registrars": [
        {
          "iana_id": 1599,
          "registrar_name": "Alibaba Cloud Computing Ltd. d/b/a HiChina (www.net.cn)",
          "new_to_zone": 101
        },
        ...
    },
    ...
  ]
}

Notes

Domain counts are collected once a day at 07:00 UTC and are generally fully processed and available by 12:30 UTC. If the domain counts are requested before this point then the counts returned will be from the previous day. Domain counts are based on the number of second level domains found in the zonefile for a particular TLD. Domains without nameservers (not in the TLD zonefile and hence not publicly available) are not included in the count.

Each TLD domain count is returned with a timestamp indicating the freshness of the data. Usually the timestamp is the same for all TLDs (the current or previous day depending on when you call the API) however occasionally the timestamp for a TLD may be one or more days earlier. This is due to the way ICANN CZDS re-authorises zone access. Once zone file access for that TLD is re-established collection resumes normally. In this case the net_zone_change key will then contain the cumulative delta over the missing days.