Domains ranking

Cloudflare regularly generates a domain ranking based on DNS queries to 1.1.1.1, Cloudflare’s public DNS resolver. Refer to the blog post Open external link for a deep dive. In short, Cloudflare generates two types of listings:

• An ordered list of the top 100 most popular domains globally and per country. This includes the last 24 hours and is updated daily.
• An unordered global most popular domains dataset, divided into buckets of the following number of domains: 200, 500, 1,000, 2,000, 5,000, 10,000, 20,000, 50,000, 100,000, 200,000, 500,000, 1,000,000. It includes the last seven days and is updated weekly.

​​ List of endpoints

​​ Top

​​ Example: Get the current ordered top domains in the Cloudflare ranking

curl "https://api.cloudflare.com/client/v4/radar/ranking/top?name=top&limit=5" \
--header "Authorization: Bearer <API_TOKEN>"

{
  "rank": 1,
  "domain": "google.com"
},
{
  "rank": 2,
  "domain": "googleapis.com"
},
{
  "rank": 3,
  "domain": "facebook.com"
},
{
  "rank": 4,
  "domain": "gstatic.com"
},
{
  "rank": 5,
  "domain": "apple.com"
}

For more information refer to Get top domains Open API docs link .

​​ Example: Download top x ranking bucket file

As mentioned in the blog post Open external link , Cloudflare provides an ordered rank for the top 100 domains, but for the remainder it only provides ranking buckets — like top 200 thousand, top one million, etc.. These are available through Cloudflare’s datasets endpoints Open API docs link .

In the following example we will request the last available domain ranking buckets:

curl "https://api.cloudflare.com/client/v4/radar/datasets?limit=10&datasetType=RANKING_BUCKET" \
--header "Authorization: Bearer <API_TOKEN>"

{
  "datasets": [
    {
      "id": 213,
      "title": "Top 1000000 ranking domains",
      "description": "Unordered top 1000000 from 2023-01-02 to 2023-01-09",
      "type": "RANKING_BUCKET",
      "tags": [
        "GLOBAL",
        "top_1000000"
      ],
      "meta": {
        "top": 1000000
      },
      "alias": "ranking_top_1000000"
    },
    ...
  ]
}

If you are interested in a specific top (like the top one million), go through the meta.top property. After finding the top you are looking for, get its id to fetch the dataset using the GET dataset download url Open API docs link endpoint.

Then you can request a download url:

curl "https://api.cloudflare.com/client/v4/radar/datasets/download" \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data '{
  "datasetId": 213
}'

{
  "dataset": {
    "url": "https://example.com/download"
  }
}

​​ Example: Get the last top x ranking bucket

This endpoint allows you to directly request the latest top x bucket available (optionally at a given date) Get dataset stream Open API docs link endpoint.

The dataset alias can be retrieved from the Get datasets Open API docs link endpoint as the example above.

This stream endpoint is only available for datasets generated after 2023-01-08.

curl "https://api.cloudflare.com/client/v4/radar/datasets/ranking_top_1000" \
--header "Authorization: Bearer <API_TOKEN>"

domain
1rx.io
2mdn.net
360yield.com
3lift.com
a-msedge.net
a2z.com
...

​​ Next steps

Refer to Investigate outages to get data from outages occurring around the world.