Get Top or Trending Domains

Get top or trending domains based on their rank. Popular domains are domains of broad appeal based on how people use the Internet. Trending domains are domains that are generating a surge in interest. For more information on top domains, see https://blog.cloudflare.com/radar-domain-rankings/.

/radar/ranking/top

get

Radar Ranking

radar-get-ranking-top-domains

Debug "planAvailability" 

{
  "business": true,
  "enterprise": true,
  "free": true,
  "pro": true
}

Debug "tokenPermissions" 

{
  "enum": [
    "com.cloudflare.api.user.read"
  ]
}

Debug "parameters" 

[
  {
    "in": "query",
    "name": "limit",
    "schema": {
      "description": "Limit the number of objects in the response.",
      "example": 5,
      "type": "integer"
    }
  },
  {
    "in": "query",
    "name": "name",
    "schema": {
      "description": "Array of names that will be used to name the series in responses.",
      "example": "main_series",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  {
    "in": "query",
    "name": "location",
    "schema": {
      "description": "Array of locations (alpha-2 country codes).",
      "example": "US",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  {
    "in": "query",
    "name": "date",
    "schema": {
      "description": "Array of dates to filter the ranking.",
      "example": "2022-09-19",
      "items": {
        "nullable": true,
        "type": "string"
      },
      "type": "array"
    }
  },
  {
    "in": "query",
    "name": "rankingType",
    "schema": {
      "default": "POPULAR",
      "description": "The ranking type.",
      "enum": [
        "POPULAR",
        "TRENDING_RISE",
        "TRENDING_STEADY"
      ],
      "example": "POPULAR",
      "type": "string"
    }
  },
  {
    "in": "query",
    "name": "format",
    "schema": {
      "description": "Format results are returned in.",
      "enum": [
        "JSON",
        "CSV"
      ],
      "example": "json",
      "type": "string"
    }
  }
]

Debug "requestBody" 

null

Debug "responses" 

{
  "200": {
    "content": {
      "application/json": {
        "schema": {
          "properties": {
            "result": {
              "properties": {
                "meta": {
                  "properties": {
                    "top_0": {
                      "properties": {
                        "date": {
                          "example": "2022-09-19",
                          "type": "string"
                        }
                      },
                      "required": [
                        "date"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "top_0"
                  ],
                  "type": "object"
                },
                "top_0": {
                  "items": {
                    "properties": {
                      "categories": {
                        "items": {
                          "properties": {
                            "id": {
                              "example": 81,
                              "type": "number"
                            },
                            "name": {
                              "example": "Content Servers",
                              "type": "string"
                            },
                            "superCategoryId": {
                              "example": 26,
                              "type": "number"
                            }
                          },
                          "required": [
                            "superCategoryId",
                            "name",
                            "id"
                          ],
                          "type": "object"
                        },
                        "type": "array"
                      },
                      "domain": {
                        "example": "google.com",
                        "type": "string"
                      },
                      "pctRankChange": {
                        "description": "Only available in TRENDING rankings.",
                        "example": 10.8,
                        "type": "number"
                      },
                      "rank": {
                        "example": 1,
                        "type": "integer"
                      }
                    },
                    "required": [
                      "rank",
                      "domain",
                      "categories"
                    ],
                    "type": "object"
                  },
                  "type": "array"
                }
              },
              "required": [
                "meta",
                "top_0"
              ],
              "type": "object"
            },
            "success": {
              "example": true,
              "type": "boolean"
            }
          },
          "required": [
            "result",
            "success"
          ],
          "type": "object"
        }
      }
    },
    "description": "Successful Response"
  },
  "400": {
    "content": {
      "application/json": {
        "schema": {
          "properties": {
            "errors": {
              "items": {
                "properties": {
                  "message": {
                    "type": "string"
                  }
                },
                "required": [
                  "message"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "result": {
              "type": "object"
            },
            "success": {
              "example": false,
              "type": "boolean"
            }
          },
          "required": [
            "result",
            "success",
            "errors"
          ],
          "type": "object"
        }
      }
    },
    "description": "Bad Request"
  }
}

Debug "security" 

[
  {
    "api_email": [],
    "api_key": []
  }
]