seo/
whois

查询域名当前的注册记录,返回注册商及其 IANA 编号、注册、更新和到期时间、状态码、域名服务器以及 DNSSEC 状态。

Whois Lookup API

当前注册记录
到期时间
注册商与 IANA 编号
域名服务器
每次请求 5 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

Whois Lookup

Whois 查询得到的是一个域名公开的注册记录,包含注册商及其 IANA 编号、注册时间、最近更新时间和到期时间、状态码、域名服务器和 DNSSEC 状态,记录中列出时还有注册人所属组织和国家。从这些时间和设置可以看出域名用了多久、注册什么时候到期、是否锁定了转移以及 DNS 委派到哪里,适合做到期监控、合作方核查和域名资产盘点。

Whois Lookup API 主要特性

  • 请求时的最新记录每次查询都在请求时读取注册记录,返回的时间和状态就是查询那一刻的情况。
  • 注册、更新和到期时间published_at、updated_at 和 expires_at 以 ISO 8601 格式给出注册时间线,从首次注册一直到当前到期日。
  • 注册商及其 IANA 编号registrar 给出管理该域名的注册商名称,registrar_iana_id 给出它的 IANA 编号,方便与注册商名单比对。
  • 状态码、域名服务器与 DNSSECstatuses 列出 client transfer prohibited 等域名状态码,nameservers 显示 DNS 委派到哪里,is_dnssec_signed 表明是否启用了 DNSSEC。
  • 子域名按注册域名查询docs.example.com 这样的主机名会按 example.com 查询,从链接或邮箱地址里拿到的主机名可以直接提交。

Whois Lookup API 参数

参数必填描述
target必填一个域名(例如 github.com)或站点根地址(例如 https://github.com/)。子域名会按其注册域名查询;只填主机名,不要带页面路径。

如何使用 Whois Lookup API

提交一个域名,以单行结果读取它的注册记录。

  1. 向 /v1/seo/whois 发送 {"target": "github.com"}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded。
  3. 从 results.items 读取这条记录;has_more 和 results.next_cursor 遵循通用分页规则,单行结果下为空。
curl -X POST "https://api.socq.ai/v1/seo/whois" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"github.com"}'

Whois Lookup API 最佳使用场景

  • 域名到期监控: 记录自有或想要的域名的 expires_at,在到期前安排复查,及时续费或抓住释放时机。
  • 核实合作方域名注册时长: 把 published_at 与当前日期比较,看合作方或新联系人的域名已经存在多久,再决定是否信任。
  • 盘点域名资产: 把各域名的 registrar、nameservers、is_dnssec_signed 和 statuses 排在一起,找出注册商不对、未启用 DNSSEC 或缺少转移锁的域名。
  • 发现注册记录变更: 结合 updated_at、statuses 和 nameservers 观察记录何时被改动,例如更换注册商或迁移 DNS 之后。

Whois Lookup API 使用建议

  • 列表里有同一域名的多个子域名时,先归并成注册域名再提交,因为它们返回的是同一行,而每次请求都计 5 积分。
  • 用 published_at、expires_at 与 collected_at 计算域名年龄和距到期天数,三者都是 ISO 8601 时间戳。
  • 按 statuses 返回的小写短语匹配状态,例如 client transfer prohibited,不要按驼峰写法的 EPP 代码匹配。

除了 Whois Lookup API,需要其他类型的 SEO 公开数据时,可以使用以下 API。

  • Google Organic SERP API — 按一个 query 和市场获取实时 Google 结果页,返回标准化目标地址、排名、元素类型和完整结果详情。
  • Keyword Difficulty API — 比较一批输入关键词的自然排名难度,为每个有可用数据的关键词返回标准化分数。
  • Keyword Overview API — 为一批输入关键词补充可用的需求、付费竞争、难度、月度搜索和搜索意图信息。
  • Backlinks Summary API — 用一行数据汇总一个域名、子域名或页面的外链概况,包括权威评分、外链与引用域名总数、垃圾分数和外链来源分布。
  • Domain Overview API — 获取一个域名在指定国家和语言下的 Google 自然与付费搜索汇总,包括排名关键词数、预估流量及广告成本、排名区间和排名变化。
  • Domain Technologies API — 按域名识别网站使用的技术,返回技术类别、权威评分、社交主页和公开的联系方式。

探索其他平台

还可以将 SEO 数据与其他已支持社交平台的公开数据结合使用。

Whois Lookup API — 常见问题

Whois Lookup API 是一个用于根据域名或子域名读取域名当前注册记录的 API。它返回注册商及其 IANA 编号、注册、更新和到期时间、状态码、域名服务器、DNSSEC 状态,以及记录中列出的注册人组织和国家。

支持 .com、.net、.org 等通用后缀,以及 .uk、.ai 等国家和地区后缀,每个域名返回完整的公开注册记录。

公开注册记录列出所有者信息时,registrant_organization 和 registrant_country 会给出注册人所属组织和国家;注册商、时间和域名服务器每个域名都会返回。

每次请求在 target 中提交一个域名;要检查一批域名,就为每个域名各提交一次请求,再汇总各自的 expires_at。

每次查询一个域名,返回一行,计 5 积分。