Network

Query Domain WHOIS Registration Information

0calls
2 credits / call

Want to know when a domain was registered, who the registrar is, and when it expires? WHOIS information can tell you all of this.

GET
uapis.cn
/api/v1/network/whois
Query parameters
2
domain
string
required

The domain name for which you need to query WHOIS information.

format
string

Return format. Leave blank or set to 'text' to return raw WHOIS text, set to 'json' to return structured JSON.

Overview

This is an online WHOIS query tool. You can obtain WHOIS information in two ways:

  • Default behavior (without parameters): GET /api/v1/network/whois?domain=google.com
    • Returns a JSON object, with the whois field as the raw, unprocessed WHOIS text string.
  • JSON formatted: GET /api/v1/network/whois?domain=google.com&format=json
    • Returns a JSON object, with the whois field as a parsed JSON object containing key-value pairs from the WHOIS information.

This way you can get both the most complete raw information and easily process structured data.

Query parameters

domain
stringrequired

The domain name for which you need to query WHOIS information.

format
stringoptional

Return format. Leave blank or set to 'text' to return raw WHOIS text, set to 'json' to return structured JSON.

Response

200 / OK

Query successful! Returns raw WHOIS text or structured JSON based on the format parameter.

Format 1

Text Format Response

When format=text or not specified, the whois field contains the raw WHOIS query text. This preserves the most complete information, suitable for scenarios where you need to parse or display raw data yourself.

JSON
{
  // WHOIS raw text, returns unprocessed original WHOIS query result text.
  "whois": "Domain Name: GOOGLE.COM\nRegistry Domain ID: 2138514_DOMAIN_COM-VRSN\nRegistrar WHOIS Server: whois.markmonitor.com\n..."
}
Format 2

JSON Format Response

When format=json, the whois field returns a structured JSON object.

Note

Note: The specific fields returned may vary depending on domain registry and privacy protection settings. Some sensitive information may be partially hidden or marked as REDACTED FOR PRIVACY.

JSON
{
  // Structured WHOIS information, returns parsed JSON object, usually containing domain information, registrar information, registrant information, and fields such as registration date, update date, expiration date, etc.
  // Some fields may vary depending on domain registry and privacy protection settings.
  "whois": {
    "domain": {
      "id": "2138514_DOMAIN_COM-VRSN",
      "domain": "google.com",
      "punycode": "google.com",
      "name": "google",
      "extension": "com",
      "whois_server": "whois.markmonitor.com",
      "status": [
        "clientDeleteProhibited",
        "clientTransferProhibited",
        "clientUpdateProhibited",
        "serverDeleteProhibited",
        "serverTransferProhibited",
        "serverUpdateProhibited"
      ],
      "name_servers": [
        "ns1.google.com",
        "ns2.google.com",
        "ns3.google.com",
        "ns4.google.com"
      ],
      "created_date": "1997-09-15T04:00:00Z",
      "created_date_in_time": "1997-09-15T04:00:00Z",
      "updated_date": "2019-09-09T15:39:04Z",
      "updated_date_in_time": "2019-09-09T15:39:04Z",
      "expiration_date": "2028-09-14T04:00:00Z",
      "expiration_date_in_time": "2028-09-14T04:00:00Z"
    },
    "registrar": {
      "id": "292",
      "name": "MarkMonitor Inc.",
      "phone": "+1.2086851750",
      "email": "abusecomplaints@markmonitor.com",
      "referral_url": "http://www.markmonitor.com"
    },
    "registrant": {
      "organization": "Google LLC",
      "country": "US",
      "email": "select request email form at https://domains.markmonitor.com/whois/google.com"
    },
    "technical": {
      "email": "select request email form at https://domains.markmonitor.com/whois/google.com"
    }
  }
}

400 / Bad Request

Invalid request parameters. Please check if the domain parameter is provided and formatted correctly.

JSON
{
  "code": "INVALID_ARGUMENT",
  "details": {},
  "message": "Missing or invalid 'domain' parameter."
}

404 / Not Found

Query failed or domain does not exist.

JSON
{
  "code": "NOT_FOUND",
  "details": {},
  "message": "WHOIS information not found for the domain."
}