--- title: NetFlows --- [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** # NetFlows ##### [Get network traffic time series](https://developers.cloudflare.com/api/python/resources/radar/subresources/netflows/methods/timeseries) radar.netflows.timeseries(NetFlowsTimeseriesParams\*\*kwargs) -> [NetFlowsTimeseriesResponse]() GET/radar/netflows/timeseries ##### [Get network traffic summary](https://developers.cloudflare.com/api/python/resources/radar/subresources/netflows/methods/summary) Deprecated radar.netflows.summary(NetFlowsSummaryParams\*\*kwargs) -> [NetFlowsSummaryResponse]() GET/radar/netflows/summary ##### [Get network traffic distribution by dimension](https://developers.cloudflare.com/api/python/resources/radar/subresources/netflows/methods/summary_v2) radar.netflows.summary\_v2(Literal\["ADM1", "AS", "LOCATION", "PRODUCT"]dimension, NetFlowsSummaryV2Params\*\*kwargs) -> [NetFlowsSummaryV2Response]() GET/radar/netflows/summary/{dimension} ##### [Get time series distribution of network traffic by dimension](https://developers.cloudflare.com/api/python/resources/radar/subresources/netflows/methods/timeseries_groups) radar.netflows.timeseries\_groups(Literal\["ADM1", "AS", "LOCATION", "PRODUCT"]dimension, NetFlowsTimeseriesGroupsParams\*\*kwargs) -> [NetFlowsTimeseriesGroupsResponse]() GET/radar/netflows/timeseries\_groups/{dimension} ##### ModelsExpand Collapse
class NetFlowsTimeseriesResponse: …
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 values: List\[str] Link to this property
Link to this property
[Link to this property](<#(resource)%20radar.netflows%20%3E%20(model)%20netflows_timeseries_response%20%3E%20(schema)>)
class NetFlowsSummaryResponse: …
meta: Meta Metadata for the results.
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
summary\_0: Summary0 http: str A numeric string. Link to this property other: str A numeric string. Link to this property
Link to this property
[Link to this property](<#(resource)%20radar.netflows%20%3E%20(model)%20netflows_summary_response%20%3E%20(schema)>)
class NetFlowsSummaryV2Response: …
meta: Meta Metadata for the results.
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 summary\_0: Dict\[str, str] Link to this property
[Link to this property](<#(resource)%20radar.netflows%20%3E%20(model)%20netflows_summary_v2_response%20%3E%20(schema)>)
class NetFlowsTimeseriesGroupsResponse: …
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.netflows%20%3E%20(model)%20netflows_timeseries_groups_response%20%3E%20(schema)>) #### NetFlowsTop ##### [Get top ASes by network traffic](https://developers.cloudflare.com/api/python/resources/radar/subresources/netflows/subresources/top/methods/ases) radar.netflows.top.ases(TopAsesParams\*\*kwargs) -> [TopAsesResponse]() GET/radar/netflows/top/ases ##### [Get top locations by network traffic](https://developers.cloudflare.com/api/python/resources/radar/subresources/netflows/subresources/top/methods/locations) radar.netflows.top.locations(TopLocationsParams\*\*kwargs) -> [TopLocationsResponse]() GET/radar/netflows/top/locations ##### ModelsExpand Collapse
class TopAsesResponse: …
meta: Meta Metadata for the results.
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
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] client\_asn: float Link to this property client\_as\_name: str Link to this property value: str A numeric string. Link to this property
Link to this property
[Link to this property](<#(resource)%20radar.netflows.top%20%3E%20(model)%20top_ases_response%20%3E%20(schema)>)
class TopLocationsResponse: …
meta: Meta Metadata for the results.
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
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] client\_country\_alpha2: str Link to this property client\_country\_name: str Link to this property value: str A numeric string. Link to this property
Link to this property
[Link to this property](<#(resource)%20radar.netflows.top%20%3E%20(model)%20top_locations_response%20%3E%20(schema)>)