WHOIS 查询 API 参考 | DomScan 产品

Q: 在哪里可以找到 WHOIS 查询 的请求和响应参考？

使用 WHOIS 查询 的 API 参考来查看参数、响应字段、示例、状态码和支持的操作模式。

你将获得什么

获取域名的 WHOIS 信息，包括注册商、日期和状态。

同步批量RESTMCPSDK交互式工具

适合选择此产品的场景

适用对象

单一决策使用专用检查，需要上下文时再构建更完整的资料。

适合选择此产品的场景

需要 WHOIS 记录和解析字段时选择，这些字段可能被脱敏、不完整或不可用。

你将获得什么

获取域名的 WHOIS 信息，包括注册商、日期和状态。

端点

集成前，请查看支持的操作、输入、输出、执行模式和响应限制。

GET /v1/whois 查看 API 参考

GET /v2/whois 查看 API 参考

POST /v1/whois/bulk 查看 API 参考

GET /v1/whois/history 查看 API 参考

积分和身份验证

3 需要身份验证。有关确切费用和按项计费，请查看操作参考。

操作示例

使用文档化的操作来收集、评估、补充、验证、比较、保护或监测公开证据。

GET /v1/whois

查询参数

参数	类型	必需
domain	string	必需

响应字段

字段	类型
`domain`	string
`registered`	boolean \| null
`available`	boolean \| null
`registrar`	string \| null
`registrar_url`	string \| null
`registrar_iana_id`	string \| null
`created_date`	string \| null
`updated_date`	string \| null
`expiry_date`	string \| null
`domain_age_days`	integer \| null
`domain_age_years`	integer \| null
`is_newly_registered`	boolean
`days_until_expiry`	integer \| null
`transfer_locked`	boolean
`nameservers[]`	string[]
`status[]`	string[]
`dnssec`	boolean
`contacts`	object
`contacts.registrant`	object
`contacts.registrant.name`	string \| null
`contacts.registrant.organization`	string \| null
`contacts.registrant.email`	string \| null
`contacts.registrant.phone`	string \| null
`contacts.registrant.fax`	string \| null
`contacts.registrant.address`	object
`contacts.registrant.address.street`	string \| null
`contacts.registrant.address.city`	string \| null
`contacts.registrant.address.state`	string \| null
`contacts.registrant.address.postal_code`	string \| null
`contacts.registrant.address.country`	string \| null
`contacts.registrant.role`	string
`contacts.admin`	object
`contacts.admin.name`	string \| null
`contacts.admin.organization`	string \| null
`contacts.admin.email`	string \| null
`contacts.admin.phone`	string \| null
`contacts.admin.fax`	string \| null
`contacts.admin.address`	object
`contacts.admin.address.street`	string \| null
`contacts.admin.address.city`	string \| null
`contacts.admin.address.state`	string \| null
`contacts.admin.address.postal_code`	string \| null
`contacts.admin.address.country`	string \| null
`contacts.admin.role`	string
`contacts.tech`	object
`contacts.tech.name`	string \| null
`contacts.tech.organization`	string \| null
`contacts.tech.email`	string \| null
`contacts.tech.phone`	string \| null
`contacts.tech.fax`	string \| null
`contacts.tech.address`	object
`contacts.tech.address.street`	string \| null
`contacts.tech.address.city`	string \| null
`contacts.tech.address.state`	string \| null
`contacts.tech.address.postal_code`	string \| null
`contacts.tech.address.country`	string \| null
`contacts.tech.role`	string
`contacts.billing`	object
`contacts.billing.name`	string \| null
`contacts.billing.organization`	string \| null
`contacts.billing.email`	string \| null
`contacts.billing.phone`	string \| null
`contacts.billing.fax`	string \| null
`contacts.billing.address`	object
`contacts.billing.address.street`	string \| null
`contacts.billing.address.city`	string \| null
`contacts.billing.address.state`	string \| null
`contacts.billing.address.postal_code`	string \| null
`contacts.billing.address.country`	string \| null
`contacts.billing.role`	string
`privacy`	object
`privacy.is_private`	boolean
`privacy.privacy_service`	string \| null
`privacy.detected_patterns[]`	string[]
`raw_rdap_link`	string \| null
`raw_whois`	string \| null
`abuse_contact`	object \| null
`registry_domain_id`	string \| null
`registrar_whois_server`	string \| null
`traditional_contacts`	object
`nameserver_ips[]`	object[]
`nameserver_ips[]`	object
`nameserver_ips[].name`	string
`nameserver_ips[].ipv4`	string \| null
`nameserver_ips[].ipv6`	string \| null
`checked_at`	string
`query_time_ms`	integer
`summary`	object
`edge_summary`	object
`edge_summary.relay_configured`	boolean
`edge_summary.data_sources[]`	string[]
`edge_summary.authoritative_source`	string
`edge_summary.relay_whois_used`	boolean
`edge_summary.raw_whois_available`	boolean
`edge_summary.parse_error_count`	integer \| null
`edge_summary.registered`	boolean \| null
`edge_summary.available`	boolean \| null
`edge_summary.registration_age_days`	integer \| null
`edge_summary.days_until_expiry`	integer \| null
`edge_summary.expires_within_30_days`	boolean \| null
`edge_summary.transfer_locked`	boolean \| null
`edge_summary.privacy_protected`	boolean \| null
`edge_summary.dnssec`	boolean \| null
`edge_summary.nameserver_count`	integer
`edge_summary.contact_roles_available[]`	string[]
`edge_summary.abuse_contact_available`	boolean
`edge_summary.registrar_whois_server`	string \| null
`meta`	object

请求示例

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

响应示例

{
  "domain": "example.com",
  "registered": false,
  "available": true,
  "registrar": "example",
  "registrar_url": "https://example.com",
  "registrar_iana_id": "example",
  "created_date": "2026-08-27T12:00:00Z",
  "updated_date": "2026-08-27T12:00:00Z",
  "expiry_date": "2026-08-27T12:00:00Z",
  "domain_age_days": 1,
  "domain_age_years": 1,
  "is_newly_registered": false,
  "days_until_expiry": 1,
  "transfer_locked": false,
  "nameservers": [
    "example"
  ],
  "status": [
    "available"
  ],
  "dnssec": false,
  "contacts": {
    "registrant": {
      "name": "example",
      "organization": "example",
      "email": "[email protected]",
      "phone": "+34612345678",
      "fax": "example",
      "address": {
        "street": "example",
        "city": "example",
        "state": "example",
        "postal_code": "example",
        "country": "US"
      },
      "role": "example"
    },
    "admin": {
      "name": "example",
      "organization": "example",
      "email": "[email protected]",
      "phone": "+34612345678",
      "fax": "example",
      "address": {
        "street": "example",
        "city": "example",
        "state": "example",
        "postal_code": "example",
        "country": "US"
      },
      "role": "example"
    },
    "tech": {
      "name": "example",
      "organization": "example",
      "email": "[email protected]",
      "phone": "+34612345678",
      "fax": "example",
      "address": {
        "street": "example",
        "city": "example",
        "state": "example",
        "postal_code": "example",
        "country": "US"
      },
      "role": "example"
    },
    "billing": {
      "name": "example",
      "organization": "example",
      "email": "[email protected]",
      "phone": "+34612345678",
      "fax": "example",
      "address": {
        "street": "example",
        "city": "example",
        "state": "example",
        "postal_code": "example",
        "country": "US"
      },
      "role": "example"
    }
  },
  "privacy": {
    "is_private": false,
    "privacy_service": "example",
    "detected_patterns": [
      "example"
    ]
  },
  "raw_rdap_link": "example",
  "raw_whois": "example",
  "abuse_contact": {},
  "registry_domain_id": "example",
  "registrar_whois_server": "example",
  "traditional_contacts": {},
  "nameserver_ips": [
    {
      "name": "example",
      "ipv4": "192.0.2.1",
      "ipv6": "2001:db8::1"
    }
  ],
  "checked_at": "2026-08-27T12:00:00Z",
  "query_time_ms": 1,
  "summary": {},
  "edge_summary": {
    "relay_configured": false,
    "data_sources": [
      "rdap"
    ],
    "authoritative_source": "rdap",
    "relay_whois_used": false,
    "raw_whois_available": true,
    "parse_error_count": 1,
    "registered": false,
    "available": true,
    "registration_age_days": 1,
    "days_until_expiry": 1,
    "expires_within_30_days": false,
    "transfer_locked": false,
    "privacy_protected": false,
    "dnssec": false,
    "nameserver_count": 1,
    "contact_roles_available": [
      "example"
    ],
    "abuse_contact_available": true,
    "registrar_whois_server": "example"
  },
  "meta": {}
}