WHOIS 查询 API 参考

请求示例

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/whois?domain=example.com"

const response = await fetch("https://domscan.net/v1/whois?domain=example.com", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);

import os
import requests

response = requests.get(
    "https://domscan.net/v1/whois?domain=example.com",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())

package main

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

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/whois?domain=example.com", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}

require "json"
require "net/http"

uri = URI("https://domscan.net/v1/whois?domain=example.com")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))

响应示例

{
  "domain": "example.com",
  "registrar": "Example Registrar, Inc.",
  "registrar_url": "https://registrar.example.net",
  "registrar_iana_id": "9999",
  "created_date": "2019-03-11T14:22:08Z",
  "updated_date": "2026-03-10T09:41:55Z",
  "expiry_date": "2027-03-11T14:22:08Z",
  "domain_age_days": 2769,
  "domain_age_years": 7,
  "is_newly_registered": false,
  "days_until_expiry": 153,
  "transfer_locked": true,
  "status": [
    "client transfer prohibited"
  ],
  "nameservers": [
    "ns1.example.net",
    "ns2.example.net"
  ],
  "dnssec": false,
  "contacts": {
    "registrant": null,
    "admin": null,
    "tech": null,
    "billing": null
  },
  "privacy": {
    "is_private": false,
    "privacy_service": null,
    "detected_patterns": []
  },
  "raw_rdap_link": "https://rdap.example.net/domain/example.com",
  "checked_at": "2026-10-09T10:15:30.000Z",
  "query_time_ms": 412,
  "registered": true,
  "summary": {
    "has_registrant": false,
    "has_admin": false,
    "has_tech": false,
    "has_billing": false,
    "contact_count": 0,
    "is_privacy_protected": false
  },
  "edge_summary": {
    "relay_configured": true,
    "data_sources": [
      "rdap"
    ],
    "authoritative_source": "rdap",
    "relay_whois_used": false,
    "raw_whois_available": false,
    "parse_error_count": null,
    "registered": true,
    "available": false,
    "registration_age_days": 2769,
    "days_until_expiry": 153,
    "expires_within_30_days": false,
    "transfer_locked": true,
    "privacy_protected": false,
    "dnssec": false,
    "nameserver_count": 2,
    "contact_roles_available": [],
    "abuse_contact_available": false,
    "registrar_whois_server": null
  },
  "meta": {
    "served_by": "pop=MAD country=ES",
    "data_source": "rdap",
    "note": "Contact information may be redacted due to privacy regulations (GDPR)"
  }
}

HTTP 状态码

• 200 成功
• 400 请求错误
• 401 未授权
• 402 需要付款
• 429 请求过多
• 502 网关错误