All Products
Search
Document Center

Anti-DDoS:DescribeDomainTopReferer

Last Updated:Mar 20, 2026

Retrieves the top N Referers for a domain.

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

A website forwarding rule must be configured for the domain name. You can call DescribeDomains to query all domain names.

example.aliyundoc.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.

1701991920

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.

1721561100

Limit

integer

Yes

The number of data entries to return.

10

QueryType

string

No

Response elements

Element

Type

Description

Example

object

RequestId

string

The unique ID that Alibaba Cloud generates for this request. You can use this ID to troubleshoot and locate issues.

CF33B4C3-196E-4015-AADD-5CAD00057B80

DomainTopReferer

array<object>

The top Referer data for the website.

object

The Referer data.

Referer

string

The Base64-encoded value of the Referer.

aHR0cHM6Ly9zZXJ2aWNld2VjaGF0LmNvbS93eGY3ZDc5YWY0YzU4ZDH3NTEvNC9wYWdlLWZyYW1lLmh0bWw=

Pv

integer

The number of matched requests.

257031

Domain

string

The domain name of the website.

example.aliyundoc.com

Examples

Success response

JSON format

{
  "RequestId": "CF33B4C3-196E-4015-AADD-5CAD00057B80",
  "DomainTopReferer": [
    {
      "Referer": "aHR0cHM6Ly9zZXJ2aWNld2VjaGF0LmNvbS93eGY3ZDc5YWY0YzU4ZDH3NTEvNC9wYWdlLWZyYW1lLmh0bWw=",
      "Pv": 257031,
      "Domain": "example.aliyundoc.com\n"
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.