Calls the DescribeRecordStatisticsSummary operation to obtain the query volume of all subdomain names under a specified domain name.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeRecordStatisticsSummary

The operation that you want to perform. Set the value to DescribeRecordStatisticsSummary.

DomainName String Yes dns-example.com

The domain name.

PageNumber Long Yes 1

The number of the page to return. Pages start from page 1. Default value: 1.

StartDate String Yes 2019-07-04

The beginning of the time range to query. Specify the time in the YYYY-MM-DD format.

You can only query DNS records of the last 90 days.

EndDate String No 2019-07-04

The end of the time range to query. Specify the time in the YYYY-MM-DD format.

The default value is the day when you perform the operation.

Keyword String No test

The keyword for searches in %KeyWord% mode. The value is not case-sensitive.

Lang String No en

The language type.

PageSize Long No 20

The number of entries to return on each page. Maximum value: 100. Minimum value: 1. Default value: 20.

SearchMode String No EXACT

The search mode of the keyword. Valid values:

  • LIKE: fuzzy match (default).
  • EXACT: exact match.
Threshold Long No 12

The threshold of query volume that can be obtained. You can also obtain data about a domain name with the query volume less than or equal to the threshold. For example, if you set this parameter to 100, you can query domain names with less than 100 queries.

Response parameters

Parameter Type Example Description
PageNumber Integer 1

The page number of the returned page.

PageSize Integer 20

The number of entries returned per page.

RequestId String E49F0023-4A98-486F-8BA3-6003D5664105

The ID of the request.

Statistics Array

The list of query volume records.

Statistic

Details about a query volume record.

Count Long 838711553

The number of queries.

SubDomain String t1.alitest2.com

The subdomain name.

TotalItems Integer 3

The total number of data records.

TotalPages Integer 1

The total number of returned pages.

Examples

Sample requests


http(s)://alidns.aliyuncs.com/?Action=DescribeRecordStatisticsSummary
&DomainName=dns-example.com
&PageNumber=1
&StartDate=2019-07-04
&<Common request parameters>

Sample success responses

XML format

<DescribeRecordStatisticsSummaryResponse>
    <PageNumber>1</PageNumber>
    <Statistics>
        <Statistic>
            <Count>838711553</Count>
            <SubDomain>t1.alitest2.com</SubDomain>
        </Statistic>
        <Statistic>
            <Count>3467</Count>
            <SubDomain>alitest2.com</SubDomain>
        </Statistic>
        <Statistic>
            <Count>487</Count>
            <SubDomain>txt.alitest2.com</SubDomain>
        </Statistic>
    </Statistics>
    <PageSize>20</PageSize>
    <RequestId>E49F0023-4A98-486F-8BA3-6003D5664105</RequestId>
    <TotalItems>3</TotalItems>
    <TotalPages>1</TotalPages>
</DescribeRecordStatisticsSummaryResponse>

JSON format

{
	"PageNumber":1,
	"Statistics":{
		"Statistic":[
			{
				"Count":838711553,
				"SubDomain":"t1.alitest2.com"
			},
			{
				"Count":3467,
				"SubDomain":"alitest2.com"
			},
			{
				"Count":487,
				"SubDomain":"txt.alitest2.com"
			}
		]
	},
	"PageSize":20,
	"RequestId":"E49F0023-4A98-486F-8BA3-6003D5664105",
	"TotalItems":3,
	"TotalPages":1
}

Error codes

For a list of error codes, visit the API Error Center.