WHOIS lookup for domain/IP/ASN

GET

/whois

package main

import (
  "fmt"
  "net/http"
  "io"
)

func main() {

  url := "https://api.dazrik.net/whois?target=example.com"

  req, _ := http.NewRequest("GET", url, nil)

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.dazrik.net/whois?target=example.com"))
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://api.dazrik.net/whois?target=example.com")
  .get()
  .build();

Response response = client.newCall(request).execute();

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.dazrik.net/whois',
  params: {target: 'example.com'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

const url = 'https://api.dazrik.net/whois?target=example.com';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

use reqwest;

#[tokio::main]
pub async fn main() {
    let url = "https://api.dazrik.net/whois";

    let querystring = [
        ("target", "example.com"),
    ];

    let client = reqwest::Client::new();
    let response = client.get(url)
        .query(&querystring)
        .send()
        .await;

    let results = response.unwrap()
        .json::<serde_json::Value>()
        .await
        .unwrap();

    dbg!(results);
}

Accepts a domain/hostname, an IP, or an ASN like ‘AS15169’ and returns WHOIS data. The shape of data depends on the target type.

Parameters

Query Parameters

target

required

string

Domain/hostname, IP address, or ASN (e.g. ‘AS15169’).

Example

example.com

Responses

200

Canonical WHOIS data

application/json

object

required

boolean

query

required

string

data

required

One of:

Canonical domain WHOIS data. All fields are optional, only populated fields are returned.

object

domainName

string

registryDomainId

string

registrar

string

registrarIanaId

string

registrarUrl

string

registrarWhoisServer

string

whoisServer

string

registrarAbuseContactEmail

string

registrarAbuseContactPhone

string

registrantName

string

registrantOrganization

string

registrantState

string

registrantCountry

string

registrantEmail

string

createdDate

string format: date-time

updatedDate

string format: date-time

expiryDate

string format: date-time

domainStatus

Array<string>

nameServer

Array<string>

dnssec

string

Example

{
  "ok": true,
  "query": "example.com",
  "data": {
    "domainName": "EXAMPLE.COM",
    "domainStatus": [
      "clientTransferProhibited"
    ],
    "dnssec": "signedDelegation"
  }
}

Headers

RateLimit

string

IETF-draft combined rate-limit header for the current window: limit, remaining, and reset (seconds until the window resets). Sent on every response from a known endpoint.

Example

limit=60, remaining=59, reset=42

RateLimit-Limit

integer

Maximum requests allowed per client IP per window (60 requests per 60s).

Example

RateLimit-Remaining

integer

Requests remaining in the current window before the limit is hit.

Example

RateLimit-Reset

integer

Seconds until the current window resets.

Example

400

Missing or invalid parameter

application/json

Error response.

object

required

boolean

msg

required

string

Example

{
  "ok": false,
  "msg": "query param target is required"
}

Headers

RateLimit

string

IETF-draft combined rate-limit header for the current window: limit, remaining, and reset (seconds until the window resets). Sent on every response from a known endpoint.

Example

limit=60, remaining=59, reset=42

RateLimit-Limit

integer

Maximum requests allowed per client IP per window (60 requests per 60s).

Example

RateLimit-Remaining

integer

Requests remaining in the current window before the limit is hit.

Example

RateLimit-Reset

integer

Seconds until the current window resets.

Example

403

Target resolves to a private/reserved address

application/json

Error response.

object

required

boolean

msg

required

string

Example

{
  "ok": false,
  "msg": "target doesn't resolve to a public addr"
}

Headers

RateLimit

string

IETF-draft combined rate-limit header for the current window: limit, remaining, and reset (seconds until the window resets). Sent on every response from a known endpoint.

Example

limit=60, remaining=59, reset=42

RateLimit-Limit

integer

Maximum requests allowed per client IP per window (60 requests per 60s).

Example

RateLimit-Remaining

integer

Requests remaining in the current window before the limit is hit.

Example

RateLimit-Reset

integer

Seconds until the current window resets.

Example

429

Rate limit exceeded: either the per-client request limit (60 requests per minute) or, for endpoints that connect to the target, the per-destination outbound connection limit.

application/json

Error response.

object

required

boolean

msg

required

string

Example

{
  "ok": false,
  "msg": "you're being rate limited, try again later."
}

Headers

RateLimit

string

IETF-draft combined rate-limit header for the current window: limit, remaining, and reset (seconds until the window resets). Sent on every response from a known endpoint.

Example

limit=60, remaining=59, reset=42

RateLimit-Limit

integer

Maximum requests allowed per client IP per window (60 requests per 60s).

Example

RateLimit-Remaining

integer

Requests remaining in the current window before the limit is hit.

Example

RateLimit-Reset

integer

Seconds until the current window resets.

Example

Retry-After

integer

Seconds to wait before retrying. Sent only on a 429 response.

Example

500

Lookup failed

application/json

object

required

boolean

msg

required

string

query

string

Example

{
  "ok": false,
  "query": "example.com",
  "msg": "couldn't get whois info"
}

Headers

RateLimit

string

IETF-draft combined rate-limit header for the current window: limit, remaining, and reset (seconds until the window resets). Sent on every response from a known endpoint.

Example

limit=60, remaining=59, reset=42

RateLimit-Limit

integer

Maximum requests allowed per client IP per window (60 requests per 60s).

Example

RateLimit-Remaining

integer

Requests remaining in the current window before the limit is hit.

Example

RateLimit-Reset

integer

Seconds until the current window resets.