--- title: Ranking --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Radar](https://developers.cloudflare.com/api/python/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/python/resources/radar/subresources/ranking/methods/timeseries_groups) radar.ranking.timeseries\_groups(RankingTimeseriesGroupsParams\*\*kwargs) -> [RankingTimeseriesGroupsResponse]() GET/radar/ranking/timeseries\_groups ##### [Get top or trending domains](https://developers.cloudflare.com/api/python/resources/radar/subresources/ranking/methods/top) radar.ranking.top(RankingTopParams\*\*kwargs) -> [RankingTopResponse]() GET/radar/ranking/top ##### ModelsExpand Collapse
class RankingTimeseriesGroupsResponse: …
meta: Meta Metadata for the results.
agg\_interval: Literal\["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
confidence\_info: MetaConfidenceInfo
annotations: List\[MetaConfidenceInfoAnnotation]
data\_source: Literal\["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: str Link to this property end\_date: datetime formatdate-time Link to this property
event\_type: Literal\["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 is\_instantaneous: bool Whether event is a single point in time or a time range. Link to this property linked\_url: str formaturi Link to this property start\_date: datetime formatdate-time Link to this property tags: Optional\[List\[str]] Link to this property
Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property
Link to this property
date\_range: List\[MetaDateRange] end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property
Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property
normalization: Literal\["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: List\[MetaUnit] Measurement units for the results. name: str Link to this property value: str Link to this property
Link to this property
Link to this property
serie\_0: Serie0 timestamps: List\[datetime] 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)>)
class RankingTopResponse: …
meta: Meta
confidence\_info: Optional\[MetaConfidenceInfo]
annotations: List\[MetaConfidenceInfoAnnotation]
data\_source: Literal\["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: str Link to this property end\_date: datetime formatdate-time Link to this property
event\_type: Literal\["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 is\_instantaneous: bool Whether event is a single point in time or a time range. Link to this property linked\_url: str formaturi Link to this property start\_date: datetime formatdate-time Link to this property tags: Optional\[List\[str]] Link to this property
Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property
Link to this property
date\_range: List\[MetaDateRange] end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property
Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property
normalization: Literal\["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: MetaTop0 date: date formatdate Link to this property
Link to this property
units: List\[MetaUnit] Measurement units for the results. name: str Link to this property value: str Link to this property
Link to this property
Link to this property
top\_0: List\[Top0]
categories: List\[Top0Category] id: int Link to this property name: str Link to this property super\_category\_id: int Link to this property
Link to this property domain: str Link to this property rank: int Link to this property pct\_rank\_change: Optional\[float] 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/python/resources/radar/subresources/ranking/subresources/domain/methods/get) radar.ranking.domain.get(strdomain, DomainGetParams\*\*kwargs) -> [DomainGetResponse]() GET/radar/ranking/domain/{domain} ##### ModelsExpand Collapse
class DomainGetResponse: …
details\_0: Details0
categories: List\[Details0Category] id: int Link to this property name: str Link to this property super\_category\_id: int Link to this property
Link to this property bucket: Optional\[str] Only available in POPULAR ranking for the most recent ranking. Link to this property rank: Optional\[int] Link to this property
top\_locations: Optional\[List\[Details0TopLocation]] location\_code: str Link to this property location\_name: str Link to this property rank: int Link to this property
Link to this property
Link to this property
meta: Meta
date\_range: List\[MetaDateRange] end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime 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/python/resources/radar/subresources/ranking/subresources/internet_services/methods/timeseries_groups) radar.ranking.internet\_services.timeseries\_groups(InternetServiceTimeseriesGroupsParams\*\*kwargs) -> [InternetServiceTimeseriesGroupsResponse]() GET/radar/ranking/internet\_services/timeseries\_groups ##### [Get top Internet services](https://developers.cloudflare.com/api/python/resources/radar/subresources/ranking/subresources/internet_services/methods/top) radar.ranking.internet\_services.top(InternetServiceTopParams\*\*kwargs) -> [InternetServiceTopResponse]() GET/radar/ranking/internet\_services/top ##### [List Internet services categories](https://developers.cloudflare.com/api/python/resources/radar/subresources/ranking/subresources/internet_services/methods/categories) radar.ranking.internet\_services.categories(InternetServiceCategoriesParams\*\*kwargs) -> [InternetServiceCategoriesResponse]() GET/radar/ranking/internet\_services/categories ##### ModelsExpand Collapse
class InternetServiceTimeseriesGroupsResponse: …
meta: Meta Metadata for the results.
agg\_interval: Literal\["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
confidence\_info: MetaConfidenceInfo
annotations: List\[MetaConfidenceInfoAnnotation]
data\_source: Literal\["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: str Link to this property end\_date: datetime formatdate-time Link to this property
event\_type: Literal\["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 is\_instantaneous: bool Whether event is a single point in time or a time range. Link to this property linked\_url: str formaturi Link to this property start\_date: datetime formatdate-time Link to this property tags: Optional\[List\[str]] Link to this property
Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property
Link to this property
date\_range: List\[MetaDateRange] end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property
Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property
normalization: Literal\["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: List\[MetaUnit] Measurement units for the results. name: str Link to this property value: str Link to this property
Link to this property
Link to this property
serie\_0: Serie0 timestamps: List\[datetime] 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)>)
class InternetServiceTopResponse: …
meta: Meta
confidence\_info: Optional\[MetaConfidenceInfo]
annotations: List\[MetaConfidenceInfoAnnotation]
data\_source: Literal\["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: str Link to this property end\_date: datetime formatdate-time Link to this property
event\_type: Literal\["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 is\_instantaneous: bool Whether event is a single point in time or a time range. Link to this property linked\_url: str formaturi Link to this property start\_date: datetime formatdate-time Link to this property tags: Optional\[List\[str]] Link to this property
Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property
Link to this property
date\_range: List\[MetaDateRange] end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property
Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property
normalization: Literal\["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: MetaTop0 date: date formatdate Link to this property service\_category: str Link to this property
Link to this property
units: List\[MetaUnit] Measurement units for the results. name: str Link to this property value: str Link to this property
Link to this property
Link to this property
top\_0: List\[Top0] rank: int Link to this property service: str 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)>)
class InternetServiceCategoriesResponse: …
categories\_0: List\[Categories0] name: str 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)>)