--- title: Ranking --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/typescript) [Radar](https://developers.cloudflare.com/api/typescript/resources/radar) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Ranking ##### [Get domains rank time series](https://developers.cloudflare.com/api/typescript/resources/radar/subresources/ranking/methods/timeseries_groups) client.radar.ranking.timeseriesGroups(RankingTimeseriesGroupsParams {dateEnd, dateRange, dateStart, 7 more } query?, RequestOptionsoptions?): [RankingTimeseriesGroupsResponse]() {meta, serie\_0 } GET/radar/ranking/timeseries\_groups ##### [Get top or trending domains](https://developers.cloudflare.com/api/typescript/resources/radar/subresources/ranking/methods/top) client.radar.ranking.top(RankingTopParams {date, domainCategory, format, 4 more } query?, RequestOptionsoptions?): [RankingTopResponse]() {meta, top\_0 } GET/radar/ranking/top ##### ModelsExpand Collapse
RankingTimeseriesGroupsResponse {meta, serie\_0 }
meta: Meta {aggInterval, confidenceInfo, dateRange, 3 more } Metadata for the results.
aggInterval: "FIFTEEN\_MINUTES"| "ONE\_HOUR"| "ONE\_DAY"| 2 more Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals. One of the following: "FIFTEEN\_MINUTES" Link to this property "ONE\_HOUR" Link to this property "ONE\_DAY" Link to this property "ONE\_WEEK" Link to this property "ONE\_MONTH" Link to this property
Link to this property
confidenceInfo: ConfidenceInfo {annotations, level }
annotations: Array<Annotation>
dataSource: "ALL"| "AI\_BOTS"| "AI\_GATEWAY"| 22 more Data source for annotations. One of the following: "ALL" Link to this property "AI\_BOTS" Link to this property "AI\_GATEWAY" Link to this property "BGP" Link to this property "BOTS" Link to this property "CONNECTION\_ANOMALY" Link to this property "CT" Link to this property "DNS" Link to this property "DNS\_MAGNITUDE" Link to this property "DNS\_AS112" Link to this property "DOS" Link to this property "EMAIL\_ROUTING" Link to this property "EMAIL\_SECURITY" Link to this property "FW" Link to this property "FW\_PG" Link to this property "HTTP" Link to this property "HTTP\_CONTROL" Link to this property "HTTP\_CRAWLER\_REFERER" Link to this property "HTTP\_ORIGINS" Link to this property "IQI" Link to this property "LEAKED\_CREDENTIALS" Link to this property "NET" Link to this property "ROBOTS\_TXT" Link to this property "SPEED" Link to this property "WORKERS\_AI" Link to this property
Link to this property description: string Link to this property endDate: string formatdate-time Link to this property
eventType: "GENERAL"| "OUTAGE"| "PARTIAL\_PROJECTION"| 2 more Event type for annotations. One of the following: "GENERAL" Link to this property "OUTAGE" Link to this property "PARTIAL\_PROJECTION" Link to this property "PIPELINE" Link to this property "TRAFFIC\_ANOMALY" Link to this property
Link to this property isInstantaneous: boolean Whether event is a single point in time or a time range. Link to this property linkedUrl: string formaturi Link to this property startDate: string formatdate-time Link to this property tags?: Array<string> Link to this property
Link to this property level: number Provides an indication of how much confidence Cloudflare has in the data. Link to this property
Link to this property
dateRange: Array<DateRange> endTime: string Adjusted end of date range. formatdate-time Link to this property startTime: string Adjusted start of date range. formatdate-time Link to this property
Link to this property lastUpdated: string Timestamp of the last dataset update. formatdate-time Link to this property
normalization: "PERCENTAGE"| "MIN0\_MAX"| "MIN\_MAX"| 5 more Normalization method applied to the results. Refer to Normalization methods. One of the following: "PERCENTAGE" Link to this property "MIN0\_MAX" Link to this property "MIN\_MAX" Link to this property "RAW\_VALUES" Link to this property "PERCENTAGE\_CHANGE" Link to this property "ROLLING\_AVERAGE" Link to this property "OVERLAPPED\_PERCENTAGE" Link to this property "RATIO" Link to this property
Link to this property
units: Array<Unit> Measurement units for the results. name: string Link to this property value: string Link to this property
Link to this property
Link to this property
serie\_0: Serie0 {timestamps } timestamps: Array<string> Link to this property
Link to this property
[Link to this property](<#(resource)%20radar.ranking%20%3E%20(model)%20ranking_timeseries_groups_response%20%3E%20(schema)>)
RankingTopResponse {meta, top\_0 }
meta: Meta {confidenceInfo, dateRange, lastUpdated, 3 more }
confidenceInfo: ConfidenceInfo| null
annotations: Array<Annotation>
dataSource: "ALL"| "AI\_BOTS"| "AI\_GATEWAY"| 22 more Data source for annotations. One of the following: "ALL" Link to this property "AI\_BOTS" Link to this property "AI\_GATEWAY" Link to this property "BGP" Link to this property "BOTS" Link to this property "CONNECTION\_ANOMALY" Link to this property "CT" Link to this property "DNS" Link to this property "DNS\_MAGNITUDE" Link to this property "DNS\_AS112" Link to this property "DOS" Link to this property "EMAIL\_ROUTING" Link to this property "EMAIL\_SECURITY" Link to this property "FW" Link to this property "FW\_PG" Link to this property "HTTP" Link to this property "HTTP\_CONTROL" Link to this property "HTTP\_CRAWLER\_REFERER" Link to this property "HTTP\_ORIGINS" Link to this property "IQI" Link to this property "LEAKED\_CREDENTIALS" Link to this property "NET" Link to this property "ROBOTS\_TXT" Link to this property "SPEED" Link to this property "WORKERS\_AI" Link to this property
Link to this property description: string Link to this property endDate: string formatdate-time Link to this property
eventType: "GENERAL"| "OUTAGE"| "PARTIAL\_PROJECTION"| 2 more Event type for annotations. One of the following: "GENERAL" Link to this property "OUTAGE" Link to this property "PARTIAL\_PROJECTION" Link to this property "PIPELINE" Link to this property "TRAFFIC\_ANOMALY" Link to this property
Link to this property isInstantaneous: boolean Whether event is a single point in time or a time range. Link to this property linkedUrl: string formaturi Link to this property startDate: string formatdate-time Link to this property tags?: Array<string> Link to this property
Link to this property level: number Provides an indication of how much confidence Cloudflare has in the data. Link to this property
Link to this property
dateRange: Array<DateRange> endTime: string Adjusted end of date range. formatdate-time Link to this property startTime: string Adjusted start of date range. formatdate-time Link to this property
Link to this property lastUpdated: string Timestamp of the last dataset update. formatdate-time Link to this property
normalization: "PERCENTAGE"| "MIN0\_MAX"| "MIN\_MAX"| 5 more Normalization method applied to the results. Refer to Normalization methods. One of the following: "PERCENTAGE" Link to this property "MIN0\_MAX" Link to this property "MIN\_MAX" Link to this property "RAW\_VALUES" Link to this property "PERCENTAGE\_CHANGE" Link to this property "ROLLING\_AVERAGE" Link to this property "OVERLAPPED\_PERCENTAGE" Link to this property "RATIO" Link to this property
Link to this property
top\_0: Top0 {date } date: string formatdate Link to this property
Link to this property
units: Array<Unit> Measurement units for the results. name: string Link to this property value: string Link to this property
Link to this property
Link to this property
top\_0: Array<Top0>
categories: Array<Category> id: number Link to this property name: string Link to this property superCategoryId: number Link to this property
Link to this property domain: string Link to this property rank: number Link to this property pctRankChange?: number Only available in TRENDING rankings. Link to this property
Link to this property
[Link to this property](<#(resource)%20radar.ranking%20%3E%20(model)%20ranking_top_response%20%3E%20(schema)>) #### RankingDomain ##### [Get domain rank details](https://developers.cloudflare.com/api/typescript/resources/radar/subresources/ranking/subresources/domain/methods/get) client.radar.ranking.domain.get(stringdomain, DomainGetParams {date, format, includeTopLocations, 3 more } query?, RequestOptionsoptions?): [DomainGetResponse]() {details\_0, meta } GET/radar/ranking/domain/{domain} ##### ModelsExpand Collapse
DomainGetResponse {details\_0, meta }
details\_0: Details0 {categories, bucket, rank, top\_locations }
categories: Array<Category> id: number Link to this property name: string Link to this property superCategoryId: number Link to this property
Link to this property bucket?: string Only available in POPULAR ranking for the most recent ranking. Link to this property rank?: number Link to this property
top\_locations?: Array<TopLocation> locationCode: string Link to this property locationName: string Link to this property rank: number Link to this property
Link to this property
Link to this property
meta: Meta {dateRange }
dateRange: Array<DateRange> endTime: string Adjusted end of date range. formatdate-time Link to this property startTime: string Adjusted start of date range. formatdate-time Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20radar.ranking.domain%20%3E%20(model)%20domain_get_response%20%3E%20(schema)>) #### RankingInternet Services ##### [Get Internet services rank time series](https://developers.cloudflare.com/api/typescript/resources/radar/subresources/ranking/subresources/internet_services/methods/timeseries_groups) client.radar.ranking.internetServices.timeseriesGroups(InternetServiceTimeseriesGroupsParams {dateEnd, dateRange, dateStart, 4 more } query?, RequestOptionsoptions?): [InternetServiceTimeseriesGroupsResponse]() {meta, serie\_0 } GET/radar/ranking/internet\_services/timeseries\_groups ##### [Get top Internet services](https://developers.cloudflare.com/api/typescript/resources/radar/subresources/ranking/subresources/internet_services/methods/top) client.radar.ranking.internetServices.top(InternetServiceTopParams {date, format, limit, 2 more } query?, RequestOptionsoptions?): [InternetServiceTopResponse]() {meta, top\_0 } GET/radar/ranking/internet\_services/top ##### [List Internet services categories](https://developers.cloudflare.com/api/typescript/resources/radar/subresources/ranking/subresources/internet_services/methods/categories) client.radar.ranking.internetServices.categories(InternetServiceCategoriesParams {date, format, limit, name } query?, RequestOptionsoptions?): [InternetServiceCategoriesResponse]() {categories\_0 } GET/radar/ranking/internet\_services/categories ##### ModelsExpand Collapse
InternetServiceTimeseriesGroupsResponse {meta, serie\_0 }
meta: Meta {aggInterval, confidenceInfo, dateRange, 3 more } Metadata for the results.
aggInterval: "FIFTEEN\_MINUTES"| "ONE\_HOUR"| "ONE\_DAY"| 2 more Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals. One of the following: "FIFTEEN\_MINUTES" Link to this property "ONE\_HOUR" Link to this property "ONE\_DAY" Link to this property "ONE\_WEEK" Link to this property "ONE\_MONTH" Link to this property
Link to this property
confidenceInfo: ConfidenceInfo {annotations, level }
annotations: Array<Annotation>
dataSource: "ALL"| "AI\_BOTS"| "AI\_GATEWAY"| 22 more Data source for annotations. One of the following: "ALL" Link to this property "AI\_BOTS" Link to this property "AI\_GATEWAY" Link to this property "BGP" Link to this property "BOTS" Link to this property "CONNECTION\_ANOMALY" Link to this property "CT" Link to this property "DNS" Link to this property "DNS\_MAGNITUDE" Link to this property "DNS\_AS112" Link to this property "DOS" Link to this property "EMAIL\_ROUTING" Link to this property "EMAIL\_SECURITY" Link to this property "FW" Link to this property "FW\_PG" Link to this property "HTTP" Link to this property "HTTP\_CONTROL" Link to this property "HTTP\_CRAWLER\_REFERER" Link to this property "HTTP\_ORIGINS" Link to this property "IQI" Link to this property "LEAKED\_CREDENTIALS" Link to this property "NET" Link to this property "ROBOTS\_TXT" Link to this property "SPEED" Link to this property "WORKERS\_AI" Link to this property
Link to this property description: string Link to this property endDate: string formatdate-time Link to this property
eventType: "GENERAL"| "OUTAGE"| "PARTIAL\_PROJECTION"| 2 more Event type for annotations. One of the following: "GENERAL" Link to this property "OUTAGE" Link to this property "PARTIAL\_PROJECTION" Link to this property "PIPELINE" Link to this property "TRAFFIC\_ANOMALY" Link to this property
Link to this property isInstantaneous: boolean Whether event is a single point in time or a time range. Link to this property linkedUrl: string formaturi Link to this property startDate: string formatdate-time Link to this property tags?: Array<string> Link to this property
Link to this property level: number Provides an indication of how much confidence Cloudflare has in the data. Link to this property
Link to this property
dateRange: Array<DateRange> endTime: string Adjusted end of date range. formatdate-time Link to this property startTime: string Adjusted start of date range. formatdate-time Link to this property
Link to this property lastUpdated: string Timestamp of the last dataset update. formatdate-time Link to this property
normalization: "PERCENTAGE"| "MIN0\_MAX"| "MIN\_MAX"| 5 more Normalization method applied to the results. Refer to Normalization methods. One of the following: "PERCENTAGE" Link to this property "MIN0\_MAX" Link to this property "MIN\_MAX" Link to this property "RAW\_VALUES" Link to this property "PERCENTAGE\_CHANGE" Link to this property "ROLLING\_AVERAGE" Link to this property "OVERLAPPED\_PERCENTAGE" Link to this property "RATIO" Link to this property
Link to this property
units: Array<Unit> Measurement units for the results. name: string Link to this property value: string Link to this property
Link to this property
Link to this property
serie\_0: Serie0 {timestamps } timestamps: Array<string> Link to this property
Link to this property
[Link to this property](<#(resource)%20radar.ranking.internet_services%20%3E%20(model)%20internet_service_timeseries_groups_response%20%3E%20(schema)>)
InternetServiceTopResponse {meta, top\_0 }
meta: Meta {confidenceInfo, dateRange, lastUpdated, 3 more }
confidenceInfo: ConfidenceInfo| null
annotations: Array<Annotation>
dataSource: "ALL"| "AI\_BOTS"| "AI\_GATEWAY"| 22 more Data source for annotations. One of the following: "ALL" Link to this property "AI\_BOTS" Link to this property "AI\_GATEWAY" Link to this property "BGP" Link to this property "BOTS" Link to this property "CONNECTION\_ANOMALY" Link to this property "CT" Link to this property "DNS" Link to this property "DNS\_MAGNITUDE" Link to this property "DNS\_AS112" Link to this property "DOS" Link to this property "EMAIL\_ROUTING" Link to this property "EMAIL\_SECURITY" Link to this property "FW" Link to this property "FW\_PG" Link to this property "HTTP" Link to this property "HTTP\_CONTROL" Link to this property "HTTP\_CRAWLER\_REFERER" Link to this property "HTTP\_ORIGINS" Link to this property "IQI" Link to this property "LEAKED\_CREDENTIALS" Link to this property "NET" Link to this property "ROBOTS\_TXT" Link to this property "SPEED" Link to this property "WORKERS\_AI" Link to this property
Link to this property description: string Link to this property endDate: string formatdate-time Link to this property
eventType: "GENERAL"| "OUTAGE"| "PARTIAL\_PROJECTION"| 2 more Event type for annotations. One of the following: "GENERAL" Link to this property "OUTAGE" Link to this property "PARTIAL\_PROJECTION" Link to this property "PIPELINE" Link to this property "TRAFFIC\_ANOMALY" Link to this property
Link to this property isInstantaneous: boolean Whether event is a single point in time or a time range. Link to this property linkedUrl: string formaturi Link to this property startDate: string formatdate-time Link to this property tags?: Array<string> Link to this property
Link to this property level: number Provides an indication of how much confidence Cloudflare has in the data. Link to this property
Link to this property
dateRange: Array<DateRange> endTime: string Adjusted end of date range. formatdate-time Link to this property startTime: string Adjusted start of date range. formatdate-time Link to this property
Link to this property lastUpdated: string Timestamp of the last dataset update. formatdate-time Link to this property
normalization: "PERCENTAGE"| "MIN0\_MAX"| "MIN\_MAX"| 5 more Normalization method applied to the results. Refer to Normalization methods. One of the following: "PERCENTAGE" Link to this property "MIN0\_MAX" Link to this property "MIN\_MAX" Link to this property "RAW\_VALUES" Link to this property "PERCENTAGE\_CHANGE" Link to this property "ROLLING\_AVERAGE" Link to this property "OVERLAPPED\_PERCENTAGE" Link to this property "RATIO" Link to this property
Link to this property
top\_0: Top0 {date, serviceCategory } date: string formatdate Link to this property serviceCategory: string Link to this property
Link to this property
units: Array<Unit> Measurement units for the results. name: string Link to this property value: string Link to this property
Link to this property
Link to this property
top\_0: Array<Top0> rank: number Link to this property service: string Link to this property
Link to this property
[Link to this property](<#(resource)%20radar.ranking.internet_services%20%3E%20(model)%20internet_service_top_response%20%3E%20(schema)>)
InternetServiceCategoriesResponse {categories\_0 }
categories\_0: Array<Categories0> name: string Link to this property
Link to this property
[Link to this property](<#(resource)%20radar.ranking.internet_services%20%3E%20(model)%20internet_service_categories_response%20%3E%20(schema)>)