Content Acceleration

IpDomainService

Update time: 2026-07-13 15:49:53

This interface is used to query the domain names that are using the IP address. The user enters the IP address to obtain the list of domain names associated with the IP. The information returned by the interface includes the current usage status of the IP and the list of domain names that use the IP. In actual applications, this interface can help users detect the domain name usage of a specific IP, which is suitable for network monitoring and management.

  • Limit of request rate per user: 300/5min
  • Applicable Products: Content Acceleration
For API authentication details, please refer to: API Authentication Overview

Request

Body Params

NameDescription
*ipList

IP

Response

Body Params

NameDescription
codeString

request result status code

messageString

Request result information

dataList

Detailed data on the results of the request

ipString

ip

statusString

Whether to use:

idle --IP not used yet; runing -- IP in use; out of range -- IP is not in a queryable range

domainListList

List of domain using this IP.The domain list of the IP that was idle or out of range was empty

Error code

Error code(code)Description(message)HTTP statusSemantic
INVALID_HTTP_REQUEST

There was an error in the body of your HTTP request.

400There was an error in the body of your HTTP request.
SYSTEM_ERROR

We encountered an system error. Please try again.

500We encountered an system error. Please try again.

Example

JSON
JSON
Request example
Copy Copy success
#!/bin/bash
username="example_username"
apiKey="example_apiKey"
date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"`
password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64`
curl -i --url "https://api.cdnetworks.com/api/tools/ip/domain-list" \
-X "POST" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json" \
-d '{
    "ip": ["1.1.1.1","2.2.2.2"]
}'
Response example
Copy Copy success
{
    "code": "0",
    "message": "success",
    "data": [
        {
            "ip": "1.1.1.1",
            "status": "idle"
        },
        {
            "ip": "2.2.2.2",
            "status": "running",
            "domainList": [
                "a.net",
                "b.net",
                "c.net",
                "d.com"
            ]
        }
    ]
}
Is the content of this document helpful to you?
Yes
I have suggestion
Submitted successfully! Thank you very much for your feedback, we will continue to strive to do better!