INTEGRITY Dokumentace

Žebříček domén

Cloudflare pravidelně generuje žebříček domén na základě DNS dotazů na 1.1.1.1, veřejný DNS resolver Cloudflare. Více informací najdete v blogový příspěvek ↗ pro podrobnější informace. Stručně řečeno, Cloudflare generuje dva typy seznamů:

Seznam koncových bodů

Nejlepší

Příklad: Získání aktuálního seřazeného seznamu top domén v žebříčku Cloudflare

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": {
		// ...
	}
}

Další informace najdete v Získat nejvýznamnější domény.

Příklad: Stažení top x soubor koše žebříčku

Jak je uvedeno v blogový příspěvek ↗, Cloudflare poskytuje seřazené pořadí pro 100 nejlepších domén, pro zbytek ale poskytuje pouze skupiny žebříčku, například top 200 tisíc, top jeden milion, atd.. Ty jsou dostupné prostřednictvím Cloudflare endpointy datových sad.

V následujícím příkladu si vyžádáme poslední dostupné buckety žebříčku domén:

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"
			},
			// ...
		]
	}
}

Pokud vás zajímá konkrétní žebříček (například top milion), projděte si meta.top . Jakmile najdete hledaný žebříček, zjistěte jeho id pro načtení datové sady pomocí GET dataset download url koncový bod.

Poté můžete požádat o URL ke stažení:

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

Příklad: Získání posledních top x koš žebříčku

Tento endpoint umožňuje přímo požádat o nejnovější dostupný top x bucket (volitelně k danému datu) Získat stream datové sady koncový bod.

Alias datové sady lze získat z Získat datové sady endpointu jako v příkladu výše.

Tento stream endpoint je dostupný pouze pro datové sady vygenerované po 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
...

Další kroky

Viz Prozkoumat výpadky pro získání dat o výpadcích, ke kterým dochází po celém světě.