All Products
Search
Document Center

Anti-DDoS:DescribeDomainTopUserAgent

Last Updated:Mar 20, 2026

Queries the top User-Agents for a website.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

Region

string

Yes

The service region. Valid values:

  • cn: the Chinese mainland.

  • cn-hongkong: outside the Chinese mainland.

cn

Domain

string

No

The domain name of the website.

Note

The domain name must be configured with a website forwarding rule. You can call DescribeDomains to query all domain names.

www.example.com

StartTime

integer

Yes

The beginning of the time range to query. This is a UNIX timestamp. Unit: seconds.

Note

The time must be specified to the minute.

1609430400

EndTime

integer

Yes

The end of the time range to query. This is a UNIX timestamp. Unit: seconds.

Note

The time must be specified to the minute.

1708352700

Limit

integer

Yes

The number of entries to return.

20

QueryType

string

No

Response elements

Element

Type

Description

Example

object

RequestId

string

The ID of the request. This unique ID is generated by Alibaba Cloud and can be used to locate and troubleshoot issues.

CF33B4C3-196E-4015-AADD-5CAD00057B80

DomainTopUa

array<object>

The list of User-Agents.

object

The User-Agent data.

UserAgent

string

The Base64-encoded User-Agent string.

TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvOTYuMC40NjY0LjExMCACYWZhcmkvNTM3LjM2

Pv

integer

The number of matched requests.

22121

Domain

string

The website domain name.

www.example.com

Examples

Success response

JSON format

{
  "RequestId": "CF33B4C3-196E-4015-AADD-5CAD00057B80",
  "DomainTopUa": [
    {
      "UserAgent": "TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvOTYuMC40NjY0LjExMCACYWZhcmkvNTM3LjM2",
      "Pv": 22121,
      "Domain": "www.example.com\n"
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.