Querying Domain Name Statistics by Region and Carrier

Function

• You can query data within the past 90 days.
• You can query up to 5 metrics each time.
• You can query up to 20 domain names each time.
• The start time and end time must be timestamps in milliseconds and must be exact time points that match the query interval. For example, if the query interval is 5 minutes, the start time and end time must be exact 5-minute intervals, for example, 0 minutes, 5 minutes, 10 minutes, and 15 minutes. If the time points do not match the query interval, the returned data may not be the expected data. If the start time is 2019-01-24 20:15:00 and the query interval is 5 minutes, the statistics in [20:15:00, 20:20:00) are queried.
• Values of action include location_detail and location_summary.
• Unit: byte for traffic-related metrics, bit/s for bandwidth-related metrics, and number of times for request quantity and status code-related metrics. You can query statistics about specific domain names by specific metrics, regions, and carriers.
• A single tenant can call this API 15 times per second.

URI

GET /v1.0/cdn/statistics/domain-location-stats

Request Parameters

None

Response Parameters

Status code: 200

Status code: default

Example Requests

• Ungrouped domain details

  GET https://{endpoint}/v1.0/cdn/statistics/domain-location-stats?action='location_summary'&start_time=1667030400000&end_time=1667116800000&domain_name='www.test1.com'&stat_type='flux'&interval=300&country='ch'&isp='swisscom'&enterprise_project_id='all'

• Domain details by domain

  GET https://{endpoint}/v1.0/cdn/statistics/domain-location-stats?action='location_summary'&start_time=1667030400000&end_time=1667116800000&domain_name='www.test1.com'&stat_type='flux'&interval=300&country='ch'&isp='swisscom'&group_by='domain'&enterprise_project_id='all'

Example Responses

Status code: 200

Success response

• Ungrouped domain details

  {
    "result" : {
      "flux" : [ 0, 1, 2 ]
    }
  }

• Details by domain

  {
    "group_by" : "domain",
    "result" : {
      "www.test1.com" : {
        "flux" : [ 0, 1, 2 ]
      },
      "www.test2.com" : {
        "flux" : [ 0, 1, 2 ]
      }
    }
  }

• Domain details by country/region

  {
    "group_by" : "country",
    "result" : {
      "ch" : {
        "flux" : [ 0, 1, 2 ]
      },
      "se" : {
        "flux" : [ 0, 1, 2 ]
      }
    }
  }

• Domain details by carrier

  {
    "group_by" : "isp",
    "result" : {
      "swisscom" : {
        "flux" : [ 0, 1, 2 ]
      },
      "telia" : {
        "flux" : [ 0, 1, 2 ]
      }
    }
  }

• Domain details by domain and country/region

  {
    "group_by" : "domain,country",
    "result" : {
      "www.test1.com" : {
        "ch" : {
          "flux" : [ 0, 1, 2 ]
        },
        "se" : {
          "flux" : [ 0, 1, 2 ]
        }
      },
      "www.test2.com" : {
        "ch" : {
          "flux" : [ 0, 1, 2 ]
        },
        "se" : {
          "flux" : [ 0, 1, 2 ]
        }
      }
    }
  }

• Domain details by domain and carrier

  {
    "group_by" : "domain,isp",
    "result" : {
      "www.test1.com" : {
        "swisscom" : {
          "req_num" : [ 0, 1, 2 ]
        }
      },
      "www.test2.com" : {
        "swisscom" : {
          "req_num" : [ 0, 1, 2 ]
        }
      }
    }
  }

• Overall domain data

  {
    "result" : {
      "flux" : 1024
    }
  }

• Overall data by domain

  {
    "group_by" : "domain",
    "result" : {
      "www.test1.com" : {
        "flux" : 1024
      },
      "www.test2.com" : {
        "flux" : 1024
      }
    }
  }

• Overall domain data by country/region

  {
    "group_by" : "country",
    "result" : {
      "ch" : {
        "flux" : 1024
      },
      "se" : {
        "flux" : 1024
      }
    }
  }

• Overall domain data by carrier

  {
    "group_by" : "isp",
    "result" : {
      "swisscom" : {
        "flux" : 1024
      },
      "telia" : {
        "flux" : 1024
      }
    }
  }

Status Codes