# TLD Stats

GET /explorer/domain-intelligence/tld-stats: Top TLDs by registrations. interval (days: 1, 7, 30, 365), size (10–10000).

Source: https://docs.deepinfo.com/reference/domain-intelligence/tld-stats/

Last updated: 2026-09-27

---
`GET https://api.deepinfo.com/v1/explorer/domain-intelligence/tld-stats`

Top TLDs by registrations. `interval` (days: 1, 7, 30, 365), `size` (10–10000).

## Authentication

Send your API key in the `apikey` request header.

## Query Parameters

| Parameter | Required | Description | Example |
|---|---|---|---|
| `interval` | Optional | One of: `1`, `7`, `30`, `365`. |  |
| `size` | Optional | One of: `10`, `100`, `1000`, `10000`. Default `10`. | `10` |

## Response Fields

An array of objects:

| Field | Type |
|---|---|
| `tld` | string |
| `count` | integer |

## Response Schema

_Inferred from examples._ Built from the saved 2xx example response: the fields it contains, with the types seen there. It is not a contract. The response body is an array; `[]` marks its elements.

| Field | Type |
|---|---|
| `[].tld` | string |
| `[].count` | number |

## Examples

### 200 · OK

```bash
curl 'https://api.deepinfo.com/v1/explorer/domain-intelligence/tld-stats' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json'
```

`Content-Type: application/json` · `deepinfo-request-id: 5f0c6a8e-1b2d-4c3e-9f4a-7b8c9d0e1f2a`

```json
[
  {
    "tld": "com",
    "count": 177403761
  },
  {
    "tld": "de",
    "count": 15208437
  }
]
```

### 400 · Invalid Parameter (invalid interval=invalid_value)

```bash
curl 'https://api.deepinfo.com/v1/explorer/domain-intelligence/tld-stats?interval=invalid_value' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json'
```

`Content-Type: application/json` · `deepinfo-request-id: 5f0c6a8e-1b2d-4c3e-9f4a-7b8c9d0e1f2a`

```json
{
  "code": 10400,
  "parameters": [
    {
      "param": "interval",
      "details": [
        "Invalid literal value."
      ]
    }
  ],
  "solution": "https://docs.deepinfo.com/reference/"
}
```

## Worked Examples

Worked examples of this endpoint, each on its own page with the exact request and its response: [TLD Stats Examples](/reference/domain-intelligence/tld-stats/examples/).

- [Top TLDs of the Last Day](/reference/domain-intelligence/tld-stats/examples/interval-1/): Top 10 TLDs of the last day: .com (68,517) far ahead of .cn (12,773) and .net.
- [Top TLDs of the Last 7 Days](/reference/domain-intelligence/tld-stats/examples/interval-7/): Top 10 TLDs of the last 7 days: .com (781,560), then .xyz, .top and .cn.
- [Top 100 TLDs of the Last 7 Days](/reference/domain-intelligence/tld-stats/examples/size-100/): The top 100 TLDs of the last 7 days (size=100), from .com (781,125) down to .boats (574).