SearchCtrl+K

DNS Lookup API Reference

Instant and precise access to DNS records (A, AAAA, MX, NS, SOA, SPF, TXT, CNAME) for any hostname. Designed for DNS troubleshooting, domain management, and network performance optimization.

GEThttps://api.apifreaks.com/v1.0/domain/dns/live

Test

The DNS Lookup API provides comprehensive DNS intelligence including A, AAAA, MX, NS, SOA, SPF, TXT, and CNAME records. Perfect for DNS troubleshooting, MX validation, domain configuration verification, and network monitoring.

Getting Started

Authentication

Pass your API key as the apiKey parameter in every request.

API Version

This is version v1.0 of the API.

LANGUAGE

curl -X 'GET' \
  'https://api.apifreaks.com/v1.0/domain/dns/live?host-name=example.com&type=all' \
  -H 'X-apiKey: API-KEY'

Response

{
  "status": true,
  "queryTime": "2026-06-06 10: 43: 05",
  "domainName": "example.com",
  "domainRegistered": true,
  "dnsTypes": {
    "A": 1,
    "NS": 2,
    "SOA": 6,
    "MX": 15,
    "TXT": 16,
    "AAAA": 28,
    "SPF": 99
  },
  "dnsRecords": [
    {
      "name": "example.com",
      "type": 1,
      "dnsType": "A",
      "ttl": 300,
      "rawText": "example.com.\t\t300\tIN\tA\t104.20.23.154",
      "rRsetType": 1,
      "address": "104.20.23.154"
    },
    {
      "name": "example.com",
      "type": 1,
      "dnsType": "A",
      "ttl": 300,
      "rawText": "example.com.\t\t300\tIN\tA\t172.66.147.243",
      "rRsetType": 1,
      "address": "172.66.147.243"
    },
    {
      "name": "example.com",
      "type": 2,
      "dnsType": "NS",
      "ttl": 21600,
      "rawText": "example.com.\t\t21600\tIN\tNS\telliott.ns.cloudflare.com.",
      "rRsetType": 2,
      "singleName": "elliott.ns.cloudflare.com."
    },
    {
      "name": "example.com",
      "type": 2,
      "dnsType": "NS",
      "ttl": 21600,
      "rawText": "example.com.\t\t21600\tIN\tNS\thera.ns.cloudflare.com.",
      "rRsetType": 2,
      "singleName": "hera.ns.cloudflare.com."
    },
    {
      "name": "example.com",
      "type": 6,
      "dnsType": "SOA",
      "ttl": 1800,
      "rawText": "example.com.\t\t1800\tIN\tSOA\telliott.ns.cloudflare.com. dns.cloudflare.com. 2405749864 10000 2400 604800 1800",
      "rRsetType": 6,
      "admin": "dns.cloudflare.com.",
      "host": "elliott.ns.cloudflare.com.",
      "expire": 604800,
      "minimum": 1800,
      "refresh": 10000,
      "retry": 2400,
      "serial": 2405749864
    },
    {
      "name": "example.com",
      "type": 15,
      "dnsType": "MX",
      "ttl": 236,
      "rawText": "example.com.\t\t236\tIN\tMX\t0 .",
      "rRsetType": 15,
      "target": ".",
      "priority": 0
    },
    {
      "name": "example.com",
      "type": 16,
      "dnsType": "TXT",
      "ttl": 300,
      "rawText": "example.com.\t\t300\tIN\tTXT\t\"_k2n1y4vw3qtb4skdx9e7dxt97qrmmq9\"",
      "rRsetType": 16,
      "strings": [
        "_k2n1y4vw3qtb4skdx9e7dxt97qrmmq9"
      ]
    },
    {
      "name": "example.com",
      "type": 28,
      "dnsType": "AAAA",
      "ttl": 300,
      "rawText": "example.com.\t\t300\tIN\tAAAA\t2606: 4700: 10: 0: 0: 0:ac42: 93f3",
      "rRsetType": 28,
      "address": "2606: 4700: 10: 0: 0: 0:ac42: 93f3"
    },
    {
      "name": "example.com",
      "type": 28,
      "dnsType": "AAAA",
      "ttl": 300,
      "rawText": "example.com.\t\t300\tIN\tAAAA\t2606: 4700: 10: 0: 0: 0: 6814: 179a",
      "rRsetType": 28,
      "address": "2606: 4700: 10: 0: 0: 0: 6814: 179a"
    },
    {
      "name": "example.com",
      "type": 99,
      "dnsType": "SPF",
      "ttl": 300,
      "rawText": "example.com.\t\t300\tIN\tSPF\t\"v=spf1 -all\"",
      "rRsetType": 99,
      "strings": [
        "v=spf1 -all"
      ]
    }
  ]
}

API Request

Query Parameters

All parameters are passed as query string parameters. At least one of host-name or ipAddress must be provided.

formatoptionalStringdefault: json

Response format: 'json' (default) or 'xml'.

host-namerequiredString

Hostname or URL whose DNS records required.

ipAddressoptionalString

The IP address for requested DNS's PTR record.

typerequiredArray

A comma-separated list of DNS record types for lookup. The values can be A, AAAA, MX, NS, SOA, SPF, TXT, CNAME, or all. When ipAddress is provided, type must be "all".

API Response Schema

A successful request returns a 200 OK response with a JSON object containing DNS records. The response includes the top-level fields listed below. See the response preview on the right for the full JSON structure.

status

Booleanmandatory

Indicates whether the query was processed successfully (true or false).

queryTime

Stringmandatory

Time at which the query was made. (Format: YYYY-MM-DD HH:mm:ss)

domainName

Stringmandatory

Queried domain.

domainRegistered

Booleanmandatory

Indicates whether the domain is registered (true) or not (false).

dnsTypes

Objectmandatory

Map of DNS record types to the number of records found for each type.

ipAddress

Stringoptional

The IP address for requested DNS PTR record. This field is present only when the ipAddress query parameter is provided.

name (String), type (Integer), dnsType (String), ttl (Integer), rawText (String), …

Error Status & Codes

See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.

400

please pass correct parameters

400

Please pass domain param correct value[For Technical Support: support@apifreaks.com]

404

No Record Found across: <HOSTNAME>

408

Unable to fetch dns records. Please try after some time. [For Technical Support email at: support@apifreaks.com]

DNS Lookup API Reference

Instant and precise access to DNS records (A, AAAA, MX, NS, SOA, SPF, TXT, CNAME) for any hostname. Designed for DNS troubleshooting, domain management, and network performance optimization.

GEThttps://api.apifreaks.com/v1.0/domain/dns/live

Test

Getting Started

Authentication

Pass your API key as the apiKey parameter in every request.

API Version

This is version v1.0 of the API.

LANGUAGE

curl -X 'GET' \
  'https://api.apifreaks.com/v1.0/domain/dns/live?host-name=example.com&type=all' \
  -H 'X-apiKey: API-KEY'

Response

{
  "status": true,
  "queryTime": "2026-06-06 10: 43: 05",
  "domainName": "example.com",
  "domainRegistered": true,
  "dnsTypes": {
    "A": 1,
    "NS": 2,
    "SOA": 6,
    "MX": 15,
    "TXT": 16,
    "AAAA": 28,
    "SPF": 99
  },
  "dnsRecords": [
    {
      "name": "example.com",
      "type": 1,
      "dnsType": "A",
      "ttl": 300,
      "rawText": "example.com.\t\t300\tIN\tA\t104.20.23.154",
      "rRsetType": 1,
      "address": "104.20.23.154"
    },
    {
      "name": "example.com",
      "type": 1,
      "dnsType": "A",
      "ttl": 300,
      "rawText": "example.com.\t\t300\tIN\tA\t172.66.147.243",
      "rRsetType": 1,
      "address": "172.66.147.243"
    },
    {
      "name": "example.com",
      "type": 2,
      "dnsType": "NS",
      "ttl": 21600,
      "rawText": "example.com.\t\t21600\tIN\tNS\telliott.ns.cloudflare.com.",
      "rRsetType": 2,
      "singleName": "elliott.ns.cloudflare.com."
    },
    {
      "name": "example.com",
      "type": 2,
      "dnsType": "NS",
      "ttl": 21600,
      "rawText": "example.com.\t\t21600\tIN\tNS\thera.ns.cloudflare.com.",
      "rRsetType": 2,
      "singleName": "hera.ns.cloudflare.com."
    },
    {
      "name": "example.com",
      "type": 6,
      "dnsType": "SOA",
      "ttl": 1800,
      "rawText": "example.com.\t\t1800\tIN\tSOA\telliott.ns.cloudflare.com. dns.cloudflare.com. 2405749864 10000 2400 604800 1800",
      "rRsetType": 6,
      "admin": "dns.cloudflare.com.",
      "host": "elliott.ns.cloudflare.com.",
      "expire": 604800,
      "minimum": 1800,
      "refresh": 10000,
      "retry": 2400,
      "serial": 2405749864
    },
    {
      "name": "example.com",
      "type": 15,
      "dnsType": "MX",
      "ttl": 236,
      "rawText": "example.com.\t\t236\tIN\tMX\t0 .",
      "rRsetType": 15,
      "target": ".",
      "priority": 0
    },
    {
      "name": "example.com",
      "type": 16,
      "dnsType": "TXT",
      "ttl": 300,
      "rawText": "example.com.\t\t300\tIN\tTXT\t\"_k2n1y4vw3qtb4skdx9e7dxt97qrmmq9\"",
      "rRsetType": 16,
      "strings": [
        "_k2n1y4vw3qtb4skdx9e7dxt97qrmmq9"
      ]
    },
    {
      "name": "example.com",
      "type": 28,
      "dnsType": "AAAA",
      "ttl": 300,
      "rawText": "example.com.\t\t300\tIN\tAAAA\t2606: 4700: 10: 0: 0: 0:ac42: 93f3",
      "rRsetType": 28,
      "address": "2606: 4700: 10: 0: 0: 0:ac42: 93f3"
    },
    {
      "name": "example.com",
      "type": 28,
      "dnsType": "AAAA",
      "ttl": 300,
      "rawText": "example.com.\t\t300\tIN\tAAAA\t2606: 4700: 10: 0: 0: 0: 6814: 179a",
      "rRsetType": 28,
      "address": "2606: 4700: 10: 0: 0: 0: 6814: 179a"
    },
    {
      "name": "example.com",
      "type": 99,
      "dnsType": "SPF",
      "ttl": 300,
      "rawText": "example.com.\t\t300\tIN\tSPF\t\"v=spf1 -all\"",
      "rRsetType": 99,
      "strings": [
        "v=spf1 -all"
      ]
    }
  ]
}

API Request

Query Parameters

All parameters are passed as query string parameters. At least one of host-name or ipAddress must be provided.

formatoptionalStringdefault: json

Response format: 'json' (default) or 'xml'.

host-namerequiredString

Hostname or URL whose DNS records required.

ipAddressoptionalString

The IP address for requested DNS's PTR record.

typerequiredArray

A comma-separated list of DNS record types for lookup. The values can be A, AAAA, MX, NS, SOA, SPF, TXT, CNAME, or all. When ipAddress is provided, type must be "all".

API Response Schema

status

Booleanmandatory

Indicates whether the query was processed successfully (true or false).

queryTime

Stringmandatory

Time at which the query was made. (Format: YYYY-MM-DD HH:mm:ss)

domainName

Stringmandatory

Queried domain.

domainRegistered

Booleanmandatory

Indicates whether the domain is registered (true) or not (false).

dnsTypes

Objectmandatory

Map of DNS record types to the number of records found for each type.

ipAddress

Stringoptional

The IP address for requested DNS PTR record. This field is present only when the ipAddress query parameter is provided.

name (String), type (Integer), dnsType (String), ttl (Integer), rawText (String), …

Error Status & Codes

See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.

400

please pass correct parameters

400

Please pass domain param correct value[For Technical Support: support@apifreaks.com]

404

No Record Found across: <HOSTNAME>

408

Unable to fetch dns records. Please try after some time. [For Technical Support email at: support@apifreaks.com]

Quick Links

Quick Links

DNS Lookup API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Error Status & Codes

Docs

Integrations

Pricing & Accounts

Quick Links

Quick Links

DNS Lookup API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Error Status & Codes

Docs

Integrations

Pricing & Accounts