Get top Internet services

client.Radar.Ranking.InternetServices.Top(ctx, query) (*RankingInternetServiceTopResponse, error)

GET/radar/ranking/internet_services/top

Retrieves top Internet services based on their rank.

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

Accepted Permissions (at least one required)

User Details WriteUser Details Read

ParametersExpand Collapse

query RankingInternetServiceTopParams

Date param.Field[[]Time]optional

Filters results by the specified array of dates.

Format param.Field[RankingInternetServiceTopParamsFormat]optional

Format in which results will be returned.

const RankingInternetServiceTopParamsFormatJson RankingInternetServiceTopParamsFormat = "JSON"

const RankingInternetServiceTopParamsFormatCsv RankingInternetServiceTopParamsFormat = "CSV"

Limit param.Field[int64]optional

Limits the number of objects returned in the response.

Name param.Field[[]string]optional

Array of names used to label the series in the response.

ServiceCategory param.Field[[]string]optional

Filters results by Internet service category.

ReturnsExpand Collapse

type RankingInternetServiceTopResponse struct{…}

Meta RankingInternetServiceTopResponseMeta

ConfidenceInfo RankingInternetServiceTopResponseMetaConfidenceInfo

Annotations []RankingInternetServiceTopResponseMetaConfidenceInfoAnnotation

DataSource RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource

Data source for annotations.

One of the following:

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceAll RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceAIBots RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceBGP RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceBots RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceCT RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "CT"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceDNS RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceDos RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceFw RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "FW"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceFwPg RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceHTTP RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceIQI RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceNet RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "NET"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceSpeed RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"

Description string

EndDate Time

formatdate-time

EventType RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsEventType

Event type for annotations.

One of the following:

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsEventTypeEvent RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsEventTypeGeneral RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsEventTypeOutage RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsEventTypePipeline RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"

const RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly RankingInternetServiceTopResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"

IsInstantaneous bool

Whether event is a single point in time or a time range.

LinkedURL string

formaturi

StartDate Time

formatdate-time

Level int64

Provides an indication of how much confidence Cloudflare has in the data.

DateRange []RankingInternetServiceTopResponseMetaDateRange

EndTime Time

Adjusted end of date range.

formatdate-time

StartTime Time

Adjusted start of date range.

formatdate-time

LastUpdated Time

Timestamp of the last dataset update.

formatdate-time

Normalization RankingInternetServiceTopResponseMetaNormalization

Normalization method applied to the results. Refer to Normalization methods.

One of the following:

const RankingInternetServiceTopResponseMetaNormalizationPercentage RankingInternetServiceTopResponseMetaNormalization = "PERCENTAGE"

const RankingInternetServiceTopResponseMetaNormalizationMin0Max RankingInternetServiceTopResponseMetaNormalization = "MIN0_MAX"

const RankingInternetServiceTopResponseMetaNormalizationMinMax RankingInternetServiceTopResponseMetaNormalization = "MIN_MAX"

const RankingInternetServiceTopResponseMetaNormalizationRawValues RankingInternetServiceTopResponseMetaNormalization = "RAW_VALUES"

const RankingInternetServiceTopResponseMetaNormalizationPercentageChange RankingInternetServiceTopResponseMetaNormalization = "PERCENTAGE_CHANGE"

const RankingInternetServiceTopResponseMetaNormalizationRollingAverage RankingInternetServiceTopResponseMetaNormalization = "ROLLING_AVERAGE"

const RankingInternetServiceTopResponseMetaNormalizationOverlappedPercentage RankingInternetServiceTopResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"

const RankingInternetServiceTopResponseMetaNormalizationRatio RankingInternetServiceTopResponseMetaNormalization = "RATIO"

Units []RankingInternetServiceTopResponseMetaUnit

Measurement units for the results.

Name string

Value string

Top0 []RankingInternetServiceTopResponseTop0

Rank int64

Service string

Get top Internet services

package main

import (
  "context"
  "fmt"

  "github.com/cloudflare/cloudflare-go"
  "github.com/cloudflare/cloudflare-go/option"
  "github.com/cloudflare/cloudflare-go/radar"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  response, err := client.Radar.Ranking.InternetServices.Top(context.TODO(), radar.RankingInternetServiceTopParams{

  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", response.Meta)
}

{
  "result": {
    "meta": {
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "level": 0
      },
      "dateRange": [
        {
          "endTime": "2022-09-17T10:22:57.555Z",
          "startTime": "2022-09-16T10:22:57.555Z"
        }
      ],
      "lastUpdated": "2019-12-27T18:11:19.117Z",
      "normalization": "PERCENTAGE",
      "units": [
        {
          "name": "*",
          "value": "requests"
        }
      ]
    },
    "top_0": [
      {
        "rank": 1,
        "service": "Google"
      }
    ]
  },
  "success": true
}

Returns Examples

{
  "result": {
    "meta": {
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "level": 0
      },
      "dateRange": [
        {
          "endTime": "2022-09-17T10:22:57.555Z",
          "startTime": "2022-09-16T10:22:57.555Z"
        }
      ],
      "lastUpdated": "2019-12-27T18:11:19.117Z",
      "normalization": "PERCENTAGE",
      "units": [
        {
          "name": "*",
          "value": "requests"
        }
      ]
    },
    "top_0": [
      {
        "rank": 1,
        "service": "Google"
      }
    ]
  },
  "success": true
}