v1/search/dns/current

This API provides the current DNS records for a specified domain, including A, AAAA, MX, NS, SOA, and TXT records.

Request URL

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

Replace {domain} with the domain you want to query, {timerange} with the desired time range (0 for real-time, 7 for one week, 30 for one month), 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
timerange int query No The time range for data: 0 (real-time), 7 (one week), 30 (one month). Defaults to 0 if not provided

Response Data 


              {
                "a": [
                    "93.184.215.14"
                ],
                "aaaa": [
                    "2606:2800:21f:cb07:6820:80da:af6b:8b2c"
                ],
                "mx": [
                    "0,"
                ],
                "ns": [
                    "a.iana-servers.net",
                    "b.iana-servers.net"
                ],
                "soa": [
                    "ns.icann.org,noc.dns.icann.org,2024081455,7200,3600,1209600,3600"
                ],
                "txt": [
                    "v=spf1 -all",
                    "wgyf8z8cgvm2qmxpnbnldrcltvk4xqfn"
                ]
            }

Explanation of DNS Record Types

  • A: Lists the IPv4 addresses for the domain.
  • AAAA: Lists the IPv6 addresses for the domain.
  • MX: Lists the mail exchange servers for the domain.
  • NS: Lists the authoritative name servers for the domain.
  • SOA: Contains the Start of Authority record, which includes administrative information about the domain.
  • TXT: Contains text records associated with the domain, often used for verification and policy purposes.