---
title: Domains ranking
description: Retrieve Cloudflare Radar domain rankings based on 1.1.1.1 DNS queries, including ordered top 100 lists and bucket datasets up to one million domains.
image: https://developers.cloudflare.com/cf-twitter-card.png
---

> Documentation Index  
> Fetch the complete documentation index at: https://developers.cloudflare.com/radar/llms.txt  
> Use this file to discover all available pages before exploring further.

[Skip to content](#%5Ftop) 

# Domains ranking

Cloudflare regularly generates a domain ranking based on DNS queries to [1.1.1.1](https://developers.cloudflare.com/1.1.1.1/), Cloudflare's public DNS resolver. Refer to the [blog post ↗](https://blog.cloudflare.com/radar-domain-rankings/) 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

Terminal window

```

curl "https://api.cloudflare.com/client/v4/radar/ranking/top?name=top&limit=5" \

--header "Authorization: Bearer <API_TOKEN>"


```

```

{

  "success": true,

  "errors": [],

  "result": {

    "top_0": [

      {

        "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"

      }

    ]

  },

  "meta": {

    // ...

  }

}


```

For more information refer to [Get top domains](https://developers.cloudflare.com/api/resources/radar/subresources/ranking/methods/top/).

#### Example: Download top `x` ranking bucket file

As mentioned in the [blog post ↗](https://blog.cloudflare.com/radar-domain-rankings/), 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](https://developers.cloudflare.com/api/resources/radar/subresources/datasets/methods/list/).

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

Terminal window

```

curl "https://api.cloudflare.com/client/v4/radar/datasets?limit=10&datasetType=RANKING_BUCKET" \

--header "Authorization: Bearer <API_TOKEN>"


```

```

{

  "success": true,

  "errors": [],

  "result": {

    "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](https://developers.cloudflare.com/api/resources/radar/subresources/datasets/methods/download/) endpoint.

Then you can request a download url:

Terminal window

```

curl "https://api.cloudflare.com/client/v4/radar/datasets/download" \

--header "Authorization: Bearer <API_TOKEN>" \

--header "Content-Type: application/json" \

--data '{

  "datasetId": 213

}'


```

```

{

  "success": true,

  "errors": [],

  "result": {

    "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](https://developers.cloudflare.com/api/resources/radar/subresources/datasets/methods/get/) endpoint.

The dataset alias can be retrieved from the [Get datasets](https://developers.cloudflare.com/api/resources/radar/subresources/datasets/methods/list/) endpoint as the example above.

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

Terminal window

```

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](https://developers.cloudflare.com/radar/investigate/outages/) to get data from outages occurring around the world.

```json
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"item":{"@id":"/directory/","name":"Directory"}},{"@type":"ListItem","position":2,"item":{"@id":"/radar/","name":"Radar"}},{"@type":"ListItem","position":3,"item":{"@id":"/radar/investigate/","name":"Investigate"}},{"@type":"ListItem","position":4,"item":{"@id":"/radar/investigate/domain-ranking-datasets/","name":"Domains ranking"}}]}
```
