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
提交一个域名,以单行结果读取它的注册记录。
- 向 /v1/seo/whois 发送 {"target": "github.com"}。
- 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded。
- 从 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 代码匹配。
相关 API
除了 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 — 按域名识别网站使用的技术,返回技术类别、权威评分、社交主页和公开的联系方式。
- Keyword Search Volume API
- Keywords for Site API
- Keyword Suggestions API
- Ranked Keywords API
- Related Keywords API
- Relevant Pages API
- Search Intent API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Competitor Domains API
- Traffic Estimate API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API