Retrieve time-series DDoS metrics for a specific IP address

Fetch and analyze DDoS (Distributed Denial of Service) attack metrics for a specified IP address. The endpoint provides time-series data, enabling users to evaluate the frequency and intensity of attacks across various time intervals, and it returns metrics in Prometheus format to offer a systematic view of DDoS attack patterns.

GET /waap/v1/ip-info/ddos

Python

Python

import os
from gcore import Gcore

client = Gcore(
    api_key=os.environ.get("GCORE_API_KEY"),  # This is the default and can be omitted
)
waap_ip_ddos_info_model = client.waap.ip_info.get_ddos_attack_series(
    ip="192.168.1.1",
)
print(waap_ip_ddos_info_model.botnet_client)

200

{
  "botnet_client": true,
  "time_series": [
    {
      "timestamp": 123,
      "count": 123
    }
  ]
}

Authorizations

Authorization · string · header · required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Query Parameters

ip · string<ipv4> string<ipv6> · required

The IP address to check

Response

200

application/json

Successful Response

botnet_client · boolean · required

Indicates if the IP is tagged as a botnet client

time_series · TimeSeriesItem · object[] · required

The time series data for the DDoS attacks from the IP address

Show child attributes