Cloudflare は、公開 DNS リゾルバーである 1.1.1.1 への DNS クエリをもとに、ドメインランキングを定期的に生成します。詳細は ブログ記事 ↗ を参照してください。要約すると、Cloudflare は次の 2 種類のリストを生成します。
- 世界全体および国別の、人気ドメイン上位 100 件の順位付きリストです。直近 24 時間を含み、毎日更新されます。
- 順位なしの、世界全体の人気ドメインデータセットです。次のドメイン数のバケットに分かれます。200、500、1,000、2,000、5,000、10,000、20,000、50,000、100,000、200,000、500,000、1,000,000。直近 7 日間を含み、毎週更新されます。
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": {
// ...
}
}詳細は Get top domains を参照してください。
ブログ記事 ↗ で述べたとおり、Cloudflare は上位 100 ドメインには順位付きランクを提供します。それ以外については、ランキングバケット(上位 20 万、上位 100 万など)だけを提供します。これらは Cloudflare の datasets エンドポイント から利用できます。
次の例では、最新のドメインランキングバケットをリクエストします。
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"
},
// ...
]
}
}特定の上位(上位 100 万など)を探すときは、meta.top プロパティを確認します。目的の上位が見つかったら、その id を使って GET dataset download url エンドポイントでデータセットを取得します。
そのあと、ダウンロード URL をリクエストできます。
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"
}
}
}このエンドポイントでは、利用可能な最新の上位 x バケットを直接リクエストできます(任意で日付を指定)。Get dataset stream エンドポイントです。
データセットのエイリアスは、上の例と同様に Get datasets エンドポイントから取得できます。
このストリームエンドポイントは、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
...世界各地で発生している障害のデータを取得するには、障害を調査する を参照してください。