NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →

DNS Lookup API

The DNS Lookup API retrieves DNS records for any given domain.

(4.5)

From 2,972 users

500+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
240ms261ms288ms469ms971ms

Didn't find what you were looking for? Suggest an improvement

/v1/dnslookup GET

https://api.api-ninjas.com/v1/dnslookup

Returns a list of DNS records associated with a particular domain.

Parameters

  • domain  required

    Valid domain to check (e.g. example.com). For top-level domains other than .com, a premium subscription is required.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON array of objects, each containing the following fields, or an error if the request is unsuccessful.

  • record_type

    Type of DNS record. Supported types:

  • value

    The value of the DNS record.

  • priority

    Priority value (for MX records).

  • mname, rname, serial, refresh, retry, expire, ttl

    Additional fields for SOA records only.

Sample Request Live Demo!

domain

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

https://api.api-ninjas.com/v1/dnslookup?domain=example.com

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
[
    {
      record_type:"A",
      value:"93.184.215.14"
    },
    {
      record_type:"AAAA",
      value:"2606:2800:21f:cb07:6820:80da:af6b:8b2c"
    },
    {
      record_type:"MX",
      priority:0,
      value:"."
    },
    {
      record_type:"NS",
      value:"b.iana-servers.net."
    },
    {
      record_type:"NS",
      value:"a.iana-servers.net."
    },
    {
      record_type:"SOA",
      mname:"ns.icann.org.",
      rname:"noc.dns.icann.org.",
      serial:2024041801,
      refresh:7200,
      retry:3600,
      expire:1209600,
      ttl:3600
    },
    {
      record_type:"TXT",
      value:"v=spf1 -all"
    },
    {
      record_type:"TXT",
      value:"wgyf8z8cgvm2qmxpnbnldrcltvk4xqfn"
    }
]

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/dnslookup?domain=example.com" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the DNS Lookup API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
  • The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
  • Send a GET request to the /v1/dnslookup endpoint with the required domain parameter set to a valid domain (e.g. example.com). Note that for top-level domains other than .com, a premium subscription is required.
  • The response is a JSON array of records identified by the record_type field, supporting A, AAAA, CNAME, MX, NS, PTR, SRV, SOA, TXT, and CAA types, with A, AAAA, CNAME, MX, and TXT requiring a premium subscription.
  • Every record includes record_type and value, while MX records also include a priority field and SOA records add mname, rname, serial, refresh, retry, expire, and ttl; you can explore the full API list for related tools.
  • It is useful for verifying domain configuration, debugging mail delivery via MX records, and auditing DNS setups, and it pairs well with the MX Lookup, Whois, and Domain APIs for deeper domain analysis.