Domain Records Lookup

DNS

API


Domain-Records-Lookup.com provides a free API for accessing WHOIS, DNS and geolocation information through a unified, consistent interface. API usage is currently limited to 500 requests per day.

Authentication


You’ll need to use a token to access the API. We automatically create an API token for each user upon Sign Up. To find your token, go to Account | API Settings.

You can pass the token to the server as an HTTP header using X-Api-Token, or as a URL parameter using &token.

All requests and responses are in JSON.

Parameters for all Requests


Name Description Type Required Notes

token

API access token

string

required

can be passed as the HTTP header X-Api-Token or as a GET token argument

domain

the domain name or website to search for

string

required

 

Whois Database Search


Retrieves detailed WHOIS data on a specified domain, including contact information, name servers, registrar, and important dates.

Method

Definition

GET

https://domain-records-lookup.com/api/1/whois?domain={:domain}\&token={:token}

 

curl -H 'X-Api-Token: {:token}'https://domain-records-lookup.com/api/1/whois?domain={:domain}

Example Requests:


curl -H 'X-Api-Token: 35aa995401e643c0b0c0fc506bf0f39a' https://domain-records-lookup.com/api/1/whois?domain=domain-records-lookup.com

or

curl https://domain-records-lookup.com/api/1/whois?domain=domain-records-lookup.com&token=35aa995401e643c0b0c0fc506bf0f39a

Example Response:


{
    "result": {
        "contacts": {
            "registrant": {
                "email": "coyvsvnqsvse@contactprivacy.email",
                "handle": "Not Available From Registry",
                "name": "Contact Privacy Inc. 124199454",
                "country": "CA",
                "city": "Toronto",
                "phone": "+1.4165385487",
                "postalcode": "M4K 3K1",
                "street": "96 Mowat Ave",
                "organization": "Contact Privacy Inc. Customer 124199454",
                "state": "ON"
            },
            "tech": null,
            "billing": {
                "email": "coyvsvnqsvse@contactprivacy.email",
                "handle": "Not Available From Registry",
                "name": "Contact Privacy Inc. 124199454",
                "country": "CA",
                "city": "Toronto",
                "phone": "+1.4165385487",
                "postalcode": "M4K 3K1",
                "street": "96 Mowat Ave",
                "organization": "Contact Privacy Inc. Customer 124199454",
                "state": "ON"
            },
            "admin": {
                "email": "coyvsvnqsvse@contactprivacy.email",
                "handle": "Not Available From Registry",
                "name": "Contact Privacy Inc. 124199454",
                "country": "CA",
                "city": "Toronto",
                "phone": "+1.4165385487",
                "postalcode": "M4K 3K1",
                "street": "96 Mowat Ave",
                "organization": "Contact Privacy Inc. Customer 124199454",
                "state": "ON"
            }
        },
        "status": "clientTransferProhibited https://icann.org/epp#clientTransferProhibited",
        "raw": [
            {
                "server": "whois.iana.org",
                "response": "% IANA WHOIS server\n% for more information on IANA, visit http://www.iana.org\n% This query returned 1 object\n\nrefer:        whois.verisign-grs.com\n\ndomain:       COM\n\norganisation: VeriSign Global Registry Services\naddress:      12061 Bluemont Way\naddress:      Reston Virginia 20190\naddress:      United States\n\ncontact:      administrative\nname:         Registry Customer Service\norganisation: VeriSign Global Registry Services\naddress:      12061 Bluemont Way\naddress:      Reston Virginia 20190\naddress:      United States\nphone:        +1 703 925-6999\nfax-no:       +1 703 948 3978\ne-mail:       info@verisign-grs.com\n\ncontact:      technical\nname:         Registry Customer Service\norganisation: VeriSign Global Registry Services\naddress:      12061 Bluemont Way\naddress:      Reston Virginia 20190\naddress:      United States\nphone:        +1 703 925-6999\nfax-no:       +1 703 948 3978\ne-mail:       info@verisign-grs.com\n\nnserver:      A.GTLD-SERVERS.NET 192.5.6.30 2001:503:a83e:0:0:0:2:30\nnserver:      B.GTLD-SERVERS.NET 192.33.14.30 2001:503:231d:0:0:0:2:30\nnserver:      C.GTLD-SERVERS.NET 192.26.92.30\nnserver:      D.GTLD-SERVERS.NET 192.31.80.30\nnserver:      E.GTLD-SERVERS.NET 192.12.94.30\nnserver:      F.GTLD-SERVERS.NET 192.35.51.30\nnserver:      G.GTLD-SERVERS.NET 192.42.93.30\nnserver:      H.GTLD-SERVERS.NET 192.54.112.30\nnserver:      I.GTLD-SERVERS.NET 192.43.172.30\nnserver:      J.GTLD-SERVERS.NET 192.48.79.30\nnserver:      K.GTLD-SERVERS.NET 192.52.178.30\nnserver:      L.GTLD-SERVERS.NET 192.41.162.30\nnserver:      M.GTLD-SERVERS.NET 192.55.83.30\nds-rdata:     30909 8 2 E2D3C916F6DEEAC73294E8268FB5885044A833FC5459588F4A9184CFC41A5766\n\nwhois:        whois.verisign-grs.com\n\nstatus:       ACTIVE\nremarks:      Registration information: http://www.verisigninc.com\n\ncreated:      1985-01-01\nchanged:      2015-05-29\nsource:       IANA\n\n"
            },
            {
                "server": "whois.verisign-grs.com",
                "response": "\nWhois Server Version 2.0\n\nDomain names in the .com and .net domains can now be registered\nwith many different competing registrars. Go to http://www.internic.net\nfor detailed information.\n\n   Domain Name: DOMAIN-RECORDS-LOOKUP.COM\n   Registrar: GOOGLE INC.\n   Sponsoring Registrar IANA ID: 895\n   Whois Server: whois.rrpproxy.net\n   Referral URL: http://domains.google.com\n   Name Server: ALEX.NS.CLOUDFLARE.COM\n   Name Server: CORTNEY.NS.CLOUDFLARE.COM\n   Status: clientTransferProhibited https://icann.org/epp#clientTransferProhibited\n   Updated Date: 20-feb-2016\n   Creation Date: 07-aug-2014\n   Expiration Date: 07-aug-2016\n\n>>> Last update of whois database: Mon, 20 Jun 2016 00:59:08 GMT <<<\n\nFor more information on Whois status codes, please visit https://icann.org/epp\n\nNOTICE: The expiration date displayed in this record is the date the\nregistrar's sponsorship of the domain name registration in the registry is\ncurrently set to expire. This date does not necessarily reflect the expiration\ndate of the domain name registrant's agreement with the sponsoring\nregistrar.  Users may consult the sponsoring registrar's Whois database to\nview the registrar's reported date of expiration for this registration.\n\nTERMS OF USE: You are not authorized to access or query our Whois\ndatabase through the use of electronic processes that are high-volume and\nautomated except as reasonably necessary to register domain names or\nmodify existing registrations; the Data in VeriSign Global Registry\nServices' (\"VeriSign\") Whois database is provided by VeriSign for\ninformation purposes only, and to assist persons in obtaining information\nabout or related to a domain name registration record. VeriSign does not\nguarantee its accuracy. By submitting a Whois query, you agree to abide\nby the following terms of use: You agree that you may use this Data only\nfor lawful purposes and that under no circumstances will you use this Data\nto: (1) allow, enable, or otherwise support the transmission of mass\nunsolicited, commercial advertising or solicitations via e-mail, telephone,\nor facsimile; or (2) enable high volume, automated, electronic processes\nthat apply to VeriSign (or its computer systems). The compilation,\nrepackaging, dissemination or other use of this Data is expressly\nprohibited without the prior written consent of VeriSign. You agree not to\nuse electronic processes that are automated and high-volume to access or\nquery the Whois database except as reasonably necessary to register\ndomain names or modify existing registrations. VeriSign reserves the right\nto restrict your access to the Whois database in its sole discretion to ensure\noperational stability.  VeriSign may restrict or terminate your access to the\nWhois database for failure to abide by these terms of use. VeriSign\nreserves the right to modify these terms at any time.\n\nThe Registry database contains ONLY .COM, .NET, .EDU domains and\nRegistrars.\n"
            },
            {
                "server": "whois.rrpproxy.net",
                "response": "Domain Name: domain-records-lookup.com\r\nRegistry Domain ID: 1870016200_DOMAIN_COM-VRSN\r\nRegistrar WHOIS Server: whois.rrpproxy.net\r\nRegistrar URL: https://domains.google.com/\r\nUpdated Date: 2016-02-20T01:27:21.0Z\r\nCreation Date: 2014-08-07T01:43:19.0Z\r\nRegistrar Registration Expiration Date: 2016-08-07T01:43:19.0Z\r\nRegistrar: Google Inc.\r\nRegistrar IANA ID: 895\r\nRegistrar Abuse Contact Email: registrar-abuse@google.com\r\nRegistrar Abuse Contact Phone: +1.8772376466\r\nDomain Status: clientTransferProhibited https://icann.org/epp#clientTransferProhibited\r\nRegistry Registrant ID: Not Available From Registry\r\nRegistrant Name: Contact Privacy Inc. 124199454\r\nRegistrant Organization: Contact Privacy Inc. Customer 124199454\r\nRegistrant Street: 96 Mowat Ave\r\nRegistrant City: Toronto\r\nRegistrant State/Province: ON\r\nRegistrant Postal Code: M4K 3K1\r\nRegistrant Country: CA\r\nRegistrant Phone: +1.4165385487\r\nRegistrant Phone Ext: \r\nRegistrant Fax: \r\nRegistrant Fax Ext: \r\nRegistrant Email: coyvsvnqsvse@contactprivacy.email\r\nRegistry Admin ID: Not Available From Registry\r\nAdmin Name: Contact Privacy Inc. 124199454\r\nAdmin Organization: Contact Privacy Inc. Customer 124199454\r\nAdmin Street: 96 Mowat Ave\r\nAdmin City: Toronto\r\nAdmin State/Province: ON\r\nAdmin Postal Code: M4K 3K1\r\nAdmin Country: CA\r\nAdmin Phone: +1.4165385487\r\nAdmin Phone Ext: \r\nAdmin Fax: \r\nAdmin Fax Ext: \r\nAdmin Email: coyvsvnqsvse@contactprivacy.email\r\nRegistry Tech ID: Not Available From Registry\r\nTech Name: Contact Privacy Inc. 124199454\r\nTech Organization: Contact Privacy Inc. Customer 124199454\r\nTech Street: 96 Mowat Ave\r\nTech City: Toronto\r\nTech Postal Code: M4K 3K1\r\nTech State/Province: ON\r\nTech Country: CA\r\nTech Phone: +1.4165385487\r\nTech Phone Ext: \r\nTech Fax: \r\nTech Fax Ext: \r\nTech Email: coyvsvnqsvse@contactprivacy.email\r\nRegistry Billing ID: Not Available From Registry\r\nBilling Name: Contact Privacy Inc. 124199454\r\nBilling Organization: Contact Privacy Inc. Customer 124199454\r\nBilling Street: 96 Mowat Ave\r\nBilling City: Toronto\r\nBilling State/Province: ON\r\nBilling Postal Code: M4K 3K1\r\nBilling Country: CA\r\nBilling Phone: +1.4165385487\r\nBilling Phone Ext: \r\nBilling Fax: \r\nBilling Fax Ext: \r\nBilling Email: coyvsvnqsvse@contactprivacy.email\r\nName Server: alex.ns.cloudflare.com \r\nName Server: cortney.ns.cloudflare.com \r\nDNSSEC: unsigned\r\nURL of the ICANN WHOIS Data Problem Reporting System: https://wdprs.internic.net/\r\n>>> Last update of WHOIS database: 2016-06-20T00:59:27.0Z <<<\r\n\r\nFor more information on Whois status codes, please visit https://www.icann.org/epp\r\n\r\nPlease register your domains at https://domains.google.com/\r\n\r\nThis data is provided by \r\nfor information purposes, and to assist persons obtaining information\r\nabout or related to domain name registration records.\r\n does not guarantee its accuracy.\r\nBy submitting a WHOIS query, you agree that you will use this data\r\nonly for lawful purposes and that, under no circumstances, you will\r\nuse this data to\r\n1) allow, enable, or otherwise support the transmission of mass\r\n   unsolicited, commercial advertising or solicitations via E-mail\r\n   (spam) or\r\n2) enable high volume, automated, electronic processes that apply\r\n   to this WHOIS server.\r\nThese terms may be changed without prior notice.\r\nBy submitting this query, you agree to abide by this policy."
            }
        ],
        "creation_date": "2014-08-07 01:43:19",
        "whois_server": "whois.rrpproxy.net",
        "updated_date": "2016-02-20 01:27:21",
        "registrar": "Google Inc.",
        "expiration_date": "2016-08-07 01:43:19",
        "id": "1870016200_DOMAIN_COM-VRSN",
        "nameservers": [
            "alex.ns.cloudflare.com",
            "cortney.ns.cloudflare.com"
        ],
        "emails": "registrar-abuse@google.com"
    },
    "status": "ok"
}

DNS Lookup


Retrieves the DNS records associated with a specified domain, including its A, AAAA, NS, MX, TXT, and SOA records.

Method

Definition

GET

https://domain-records-lookup.com/api/1/dns?domain={:domain}&token={:token}

 

curl -H 'X-Api-Token: {:token}' https://domain-records-lookup.com/api/1/dns?domain={:domain}

Example Requests:


curl -H 'X-Api-Token: 35aa995401e643c0b0c0fc506bf0f39a' https://domain-records-lookup.com/api/1/dns?domain=domain-records-lookup.com

or

curl https://domain-records-lookup.com/api/1/dns?domain=domain-records-lookup.com&token=35aa995401e643c0b0c0fc506bf0f39a

Example Response:


{
    "status": "ok",
    "result": {
        "IP": "69.197.163.226",
        "NS": [
            "cortney.ns.cloudflare.com.",
            "alex.ns.cloudflare.com."
        ],
        "A": [
            "69.197.163.226"
        ],
        "TXT": [
            "\"google-site-verification=8bTyuB_dek3pn-9FdY72pB47R9YvKqZcUKPxqna-1gw\""
        ],
        "SOA": [
            {
                "serial": "2021507585",
                "server": "alex.ns.cloudflare.com.",
                "refresh": "2:46:40",
                "email": "dns.cloudflare.com.",
                "string": "alex.ns.cloudflare.com. dns.cloudflare.com. 2021507585 10000 2400 604800 3600",
                "retry": "0:40:00",
                "expire": "7 days, 0:00:00",
                "min_ttl": "3600"
            }
        ],
        "MX": [
            {
                "exchange": "gmr-smtp-in.l.google.com.",
                "preference": "5"
            },
            {
                "exchange": "alt4.gmr-smtp-in.l.google.com.",
                "preference": "40"
            },
            {
                "exchange": "alt3.gmr-smtp-in.l.google.com.",
                "preference": "30"
            },
            {
                "exchange": "alt2.gmr-smtp-in.l.google.com.",
                "preference": "20"
            },
            {
                "exchange": "alt1.gmr-smtp-in.l.google.com.",
                "preference": "10"
            }
        ]
    }
}

IP Lookup


Retrieves the IP address geolocation information associated with a specified domain, including the country, region, state, city, latitude and longitude coordinates, and IP address itself.

Method Definition

GET

https://domain-records-lookup.com/api/1/ip?domain={:domain}\&token={:token}

 

curl -H 'X-Api-Token: {:token}' https://domain-records-lookup.com/api/1/ip?domain={:domain}

Example Request:


curl -H 'X-Api-Token: 35aa995401e643c0b0c0fc506bf0f39a' https://domain-records-lookup.com/api/1/ip?address=domain-records-lookup.com

Example Response:


{
    "status": "ok",
    "result": {
        "location": {
            "country": "United States",
            "latitude": "39.0997",
            "postal_code": "64106",
            "region": "MO",
            "country_short": "US",
            "city": "Kansas City",
            "longitude": "-94.5786"
        },
        "address": "69.197.163.226"
    }
}

Response Elements


Whois Database Search


Name       Description Type Notes

result

 

 

 

top level

response data object

 

 

contacts

 

 

secondary level

contact data object

 

 

 

registrant

 

tertiary level

registrant contact  data object

 

 

 

 

email

the registrant's email address

string

 

 

 

 

handle

the registrant's  handle

string

 

 

 

 

name

the registrant's  name

string

 

 

 

 

country

the country in which the registrant is located

string

 

 

 

 

city

the city in which the registrant is located

string

 

 

 

 

phone

the registrant's  phone number

string

 

 

 

 

postalcode

the registrant's postal code

string

 

 

 

 

street

the registrant's street address

string

 

 

 

 

organization

the name of the registrant's company, if any

string

 

 

 

 

state

the state in which the registrant is located

string

 

 

 

tech

 

tertiary level

technical contact data object

contains the same contact elements as the registrant object

 

 

billing

 

tertiary level

billing contact data object

contains the same contact elements as the registrant object

 

 

admin

 

tertiary level

administrative contact data object

contains the same contact elements as the registrant object

 

 

status

 

the client status code, as set by registrar

string

 

 

 

raw

 

a wrapper for unformatted Whois data

array

 

 

 

 

server

the server returning the raw data

string

 

 

 

 

response

the raw data the Whois server has returned

string

 

 

 

creation_date

 

the date the registration was created

date & time

 

 

 

whois_server

 

the address for the Whois server

string

 

 

 

updated_date

 

the date the registration was last updated

date & time

 

 

 

registrar

 

the name of the registrar

string

 

 

 

expiration_date

 

the date the registration expires

date & time

 

 

 

id

 

the registration's unique ID

string

 

 

 

nameservers

 

the name servers associated with the domain

array

 

 

 

emails

 

the email address for the administrator of the domain's zone file

string

 

 

status

 

 

the HTTP response for the status of the request

string

 

DNS Lookup


Name     Description Type Notes

status

 

 

the HTTP status of the request

string

 

result

 

 

top level

response data object

 

 

IP

 

the IP address associated with the domain

binary(4)

 

 

NS

 

key containing information from the domain's NS records

an array of subdomains

 

 

A

 

key containing information from the domain's A records

an array containing the IP address associated with the domain

 

 

TXT

 

key containing free text from the domain's TXT records

array

 

 

SOA

 

key containing information from the domain's SOA records

array

 

 

 

serial

the revision number for the domain's zone file

integer

 

 

 

server

primary name server for the domain

string

 

 

 

refresh

the number of seconds before the zone should be refreshed

integer

 

 

 

email

the email address for the administrator of the domain's zone file

string

uses a period (.) instead of an @ in the email address

 

 

string

the data from the SOA record presented as single string

string

 

 

 

retry

the number of seconds before a failed refresh should be retried

integer

default is 600

 

 

expire

the duration (in seconds) that a secondary server will wait before retrying a failed zone transfer

integer

default is 86,400

 

 

min_ttl

the minimum time-to-live value for all resource records in the zone file

 

default is 3,600

 

MX

 

key containing information from the domain's MX records

array

 

 

 

exchange

the mail server(s) associated with the domain

string

 

 

 

preference

the mail server's priority level

integer

 

IP Lookup


Name     Description Type

status

 

 

the HTTP status of the request

string

result

 

 

top level

response data object

 

location

 

a wrapper for the location information

location data object

 

 

country

the country in which the domain is hosted

string

 

 

latitude

the latitude coordinate associated with the domain's IP address

decimal

 

 

postal_code

the registrant's zip code

string

 

 

region

the region in which the domain is hosted

string

 

 

country_short

the abbreviation for the country in which the domain is hosted

string

 

 

city

the city in which the domain is hosted

string

 

 

longitude

the longitude coordinate associated with the domain's IP address

decimal

 

address

 

the IP address associated with the domain

string