v1/search/dns/history

This API provides the DNS history for a specified domain, including changes over a specified time range.

Request URL

curl -X GET "https://api.securitysurface.com/v1/search/dns/history?domain={domain}&type={type}&page={page}" \
-H "apikey: your_api_key" \
-H "Content-Type: application/json"

Replace {domain} with the domain you want to query, and your_api_key with your actual API key.

Request Parameters

Parameter Type Location Required Description
domain string query Yes The domain to query, e.g., example.com
type string query Yes The type of DNS record to query, A, AAAA, MX, NS, SOA, TXT.
page int query Yes The page number for pagination.

Response Data 


{
    "status": "ss_success",
    "totalRecords": 10,
    "totalPages": 1,
    "currentPage": 1,
    "historicalDnsRecords": [
        {
            "queryTime": "2025-08-14",
            "domainName": "example.com.",
            "dnsTypes": {
                "A": 1
            },
            "dnsRecords": [
                {
                    "name": "example.com",
                    "type": 1,
                    "dnsType": "A",
                    "ttl": 4,
                    "rawText": "example.com.\t\t4\tIN\tA\t96.7.128.175",
                    "rRsetType": 1,
                    "address": "96.7.128.175"
                },
                {
                    "name": "example.com",
                    "type": 1,
                    "dnsType": "A",
                    "ttl": 4,
                    "rawText": "example.com.\t\t4\tIN\tA\t96.7.128.198",
                    "rRsetType": 1,
                    "address": "96.7.128.198"
                }
            ]
        },
        {
            "queryTime": "2025-11-13",
            "domainName": "example.com.",
            "dnsTypes": {
                "A": 1
            },
            "dnsRecords": [
                {
                    "name": "example.com",
                    "type": 1,
                    "dnsType": "A",
                    "ttl": 4,
                    "rawText": "example.com.\t\t4\tIN\tA\t23.192.228.84",
                    "rRsetType": 1,
                    "address": "23.192.228.84"
                },
                {
                    "name": "example.com",
                    "type": 1,
                    "dnsType": "A",
                    "ttl": 4,
                    "rawText": "example.com.\t\t4\tIN\tA\t23.215.0.138",
                    "rRsetType": 1,
                    "address": "23.215.0.138"
                },
                {
                    "name": "example.com",
                    "type": 1,
                    "dnsType": "A",
                    "ttl": 278,
                    "rawText": "example.com.\t\t278\tIN\tA\t23.220.75.232",
                    "rRsetType": 1,
                    "address": "23.220.75.232"
                },
                {
                    "name": "example.com",
                    "type": 1,
                    "dnsType": "A",
                    "ttl": 4,
                    "rawText": "example.com.\t\t4\tIN\tA\t23.192.228.80",
                    "rRsetType": 1,
                    "address": "23.192.228.80"
                },
                {
                    "name": "example.com",
                    "type": 1,
                    "dnsType": "A",
                    "ttl": 4,
                    "rawText": "example.com.\t\t4\tIN\tA\t23.215.0.136",
                    "rRsetType": 1,
                    "address": "23.215.0.136"
                },
                {
                    "name": "example.com",
                    "type": 1,
                    "dnsType": "A",
                    "ttl": 278,
                    "rawText": "example.com.\t\t278\tIN\tA\t23.220.75.245",
                    "rRsetType": 1,
                    "address": "23.220.75.245"
                }
            ]
        },
        {
            "queryTime": "2024-12-17",
            "domainName": "example.com.",
            "dnsTypes": {
                "A": 1
            },
            "dnsRecords": [
                {
                    "name": "example.com",
                    "type": 1,
                    "dnsType": "A",
                    "ttl": 1925,
                    "rawText": "example.com.\t\t1925\tIN\tA\t93.184.215.14",
                    "rRsetType": 1,
                    "address": "93.184.215.14"
                }
            ]
        },
        {
            "queryTime": "2024-03-11",
            "domainName": "example.com.",
            "dnsTypes": {
                "A": 1
            },
            "dnsRecords": [
                {
                    "name": "example.com",
                    "type": 1,
                    "dnsType": "A",
                    "ttl": 21600,
                    "rawText": "example.com.\t\t21600\tIN\tA\t93.184.216.34",
                    "rRsetType": 1,
                    "address": "93.184.216.34"
                }
            ]
        }
    ]
}