域名年龄 API
查询域名注册时间、到期时间和注册年龄，了解参数、字段、计算方式及计费规则。
查询域名当前可获取的注册记录，计算完整注册天数。可结合 DR、流量和外链研究使用；注册年龄不等同于网站质量或网站上线时间。
测试域名年龄 API →接口与鉴权
GET https://api.goanyapi.com/api/v1/domain-ageAuthorization: Bearer YOUR_API_KEY当前配置下，每次成功请求消耗 1 积分。
只有注册时间有效且能计算年龄的请求按当前配置计费，0 天是有效结果且正常计费。成功响应无法获取有效注册时间时免费，age_days 返回 null。缺少到期时间不影响计费。参数错误、鉴权错误、余额不足和请求失败不扣积分。实时查询前仍需通过鉴权和余额检查，即使最终未获取年龄。每次实时查询独立计费。
请求参数
domain 必填，只接受文档中的参数且不得重复。域名规范化与 DR 接口一致。子域名会保留，不会静默替换为父域名，结果取决于可获取的注册记录。
| 字段 | 类型 | 说明 |
|---|---|---|
domain | string | 一个域名，例如 example.com。自动移除 URL 前缀、路径、端口及末尾点，保留子域名；输入最多 2048 字符，规范化后最多 253 字符。 |
请求示例
GET /api/v1/domain-age?domain=example.com
Authorization: Bearer YOUR_API_KEY响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
data.endpoint | string | 固定接口标识 domain-age。 |
data.costCredits | number | 按数据库当前价格实际扣除的积分；无法计算年龄及失败免费。 |
data.remainingCredits | number | 请求后的账户剩余积分。 |
data.query.domain | string | 规范化后的请求域名。 |
data.domain | string | 本次查询的规范化目标域名。 |
data.registration | string / null / missing | 原始注册时间业务值，可以为空、null 或缺失，不补造时间。 |
data.expiration | string / null / missing | 原始到期时间业务值，可以为空、null 或缺失，不影响年龄计费。 |
data.age_days | integer / null | 截至 as_of 已经过的完整 24 小时数，向下取整。ISO 纯日期按 UTC 零点，时间戳须有明确时区。缺失、无效或未来时间返回 null，0 是有效年龄。 |
data.as_of | string | 计算年龄采用的 UTC ISO 时间；保存示例使用原始计算时间及年龄。 |
注册和到期时间保留原始业务值，包括 null、空字符串及字段缺失。其他异常业务值仍按公开字段白名单输出，不会仅因此判定整次请求失败。不补造注册日期；无法获取年龄不等于确认该域名未注册。
年龄计算
age_days = floor((as_of − registration) / 86400000)，时间戳按毫秒计算。统计已完整经过的 24 小时数，包含闰日，不使用四舍五入的年数。ISO 纯日期按 UTC 零点处理，日期时间须带明确时区。无效日历日期、缺失时间及晚于 as_of 的未来注册时间返回 null，不计费。expiration 不参与年龄计算。本接口不提供历次注册事件或所有权历史。
本地保存的真实响应示例
示例保存在本地，as_of 和 age_days 固定为采集时的数据，预览不发送实时请求。实际响应还包含 costCredits 和 remainingCredits，分别读取当前价格配置和账户余额。
{ "code": "ok", "message": "Saved example response", "data": { "endpoint": "domain-age", "query": { "domain": "example.com" }, "domain": "example.com", "registration": "1995-08-14T04:00:00Z", "expiration": "2027-08-13T04:00:00Z", "age_days": 11411, "as_of": "2026-11-11T03:31:33.011Z" }}错误说明
400 invalid_params：缺少、无效、重复或未知参数；401：需要鉴权；402 insufficient_credits：余额不足；429：请求限流；503 service_not_configured：服务或价格未配置；502 request_failed：HTTP、业务失败或无效 JSON；504 request_timeout：查询超时。失败不扣积分。成功响应中的空日期正常返回，不因字段为空而返回 502。