域名后缀列表 API

查询顶级域名后缀列表

GET /api/tld

请求参数

• q：模糊搜索，匹配后缀（可带点，如 .cn）、中文形式（如 中国）或中文说明（如 电商），示例 cn
• type：按类型过滤：gtld 通用顶级域、cctld 国家和地区顶级域、idn 国际化域名，示例 idn

返回字段

• source（string）：数据来源：iana 为 IANA 官方列表（缓存 1 天）；builtin 为上游不可用时的内置常用后缀
• fallback（boolean）：是否使用了内置的备用列表（true 时列表不完整，只有 107 个常用后缀）
• version（string|null）：IANA 列表的版本说明（原文，如 Version 2026092400, Last Updated Wed Sep 24 07:07:01 2026 UTC）；使用内置列表时为 null
• total（number）：列表中的后缀总数（过滤前）
• count（number）：符合 q 和 type 条件的后缀数（即 items 的长度）
• stats（object）：各类型的后缀数量（过滤前）
• stats.gTLD（number）：通用顶级域数量（含 com、net 等传统后缀和新通用顶级域）
• stats.ccTLD（number）：国家和地区顶级域数量（两位字母，如 cn、us）
• stats.IDN（number）：国际化域名后缀数量（xn-- 开头，如 中国、公司）
• items（array）：后缀列表：未搜索时按字母顺序；搜索时按匹配程度排序（完全相同 → 前缀匹配 → 包含）
• items[].tld（string）：后缀的 ASCII 形式（小写，不带点；国际化域名为 punycode，如 xn--fiqs8s）
• items[].unicode（string）：显示用的形式：国际化域名解码为 Unicode（如 中国），其他与 tld 相同
• items[].type（string）：类型：gTLD 通用顶级域；ccTLD 国家和地区顶级域（两位字母）；IDN 国际化域名（xn-- 开头，包括中国、香港等中文国家和地区后缀）
• items[].note（string|null）：中文说明，仅常见的中文相关后缀（cn、中国、公司、网络、香港等）和常用后缀（com、io 等）有；其他为 null