域名交易市场 API 参数详解与接入最佳实践

适用场景域名交易市场为站长、域名投资人及行业研究人员提供从 EDNS 公开交易数据中获取域名列表、用量说明、交易类型等信息的便捷途径。常见场景包括扫货短米通过max_length和max_price筛选出用量说明合理、长度较短的域名用于建站或转售。行业研究按后缀如.com、.cn和交易类型一口价、竞拍统计市场成交活跃度。行情监测定期轮询接口结合sale_type与price构建用量说明趋势预警。接口能力边界接口限速QPS 5即每秒最多请求 5 次超出将返回 429 Too Many Requests。每次最多返回 100 条记录pagesize ≤ 100总页数由服务端动态计算。支持的筛选维度包括用量说明上限、域名长度上限、后缀和交易类型均为可选参数。数据为公开的 EDNS 域名交易市场快照不承诺实时性部分最近成交记录可能存在延迟。鉴权方式所有请求必须在 HTTP 头部携带X-API-Key值为从控制台获取的 API 密钥。示例X-API-Key: your_actual_api_key密钥需妥善保管不要硬编码在公开代码仓库中。推荐使用环境变量注入。参数详解参数名类型必填默认值说明pagenumber否1页码从 1 开始pagesizenumber否50每页条数最大值 100max_pricenumber否无筛选用量说明≤该值的域名单位元max_lengthnumber否无筛选域名长度≤该值不含后缀suffixstring否无指定后缀如.com、.netsale_typestring否无交易类型如一口价、竞拍注意参数值不应包含特殊符号suffix 带点号。若传入不存在的交易类型接口仍会返回结果但可能为空。可复制的 curl 请求示例以下示例演示获取第 2 页、每页 30 条、用量说明不超过 1000、后缀为.com的一口价域名# 替换 YOUR_API_KEY 为真实密钥 curl -sS \ -X GET \ -H X-API-Key: YOUR_API_KEY \ https://v1.apizero.cn/api/domain-trade?page2pagesize30max_price10000suffix.comsale_type一口价返回体示例JSON{ code: 0, data: { count: 30, current_page: 2, list: [ { name: short.io, price: 3200, sale_type: 一口价 }, { name: mybox.com, price: 8900, sale_type: 一口价 } ], total_pages: 50 }, msg: 成功 }返回值解读顶层字段说明code业务状态码0表示成功非0表示错误。msg描述信息成功时通常为“成功”。data分页数据对象包含count当前页实际条数、current_page当前页码、list域名列表、total_pages总页数。list中每项字段字段名类型说明namestring域名全名含后缀pricestring用量说明单位为元字符串sale_typestring交易类型一口价 / 竞拍等注意price使用字符串而非数值因为部分用量说明可能包含小数或较长数字前端展示或比较时需转为数值。常见错误处理HTTP 状态码可能原因解决方式401 UnauthorizedAPI Key 缺失或无效检查X-API-Key是否正确设置429 Too Many Requests超过 QPS 限制降低请求频率加入退避策略400 Bad Request参数非法如 pagesize 100校验参数范围500 Internal Server Error服务端异常等待后重试若持续发生请联系技术支持业务错误返回code ! 0code1001参数格式错误如 page 为负数。code1002后缀格式不正确缺少点号等。code1003交易类型不在允许列表中以文档为准。工程化注意事项并发控制QPS 5 意味着不推荐使用单进程同步循环请求。若需采集多页数据应使用令牌桶或信号量限制并发例如每秒只发起 5 个请求。分页遍历策略获取total_pages后逐页请求但应合理设置pagesize以减少请求次数。推荐 pagesize100。重试与容错对 429 和 5xx 实现指数退避重试如初始等待 1 秒最多 3 次。数据存储用量说明字段建议以分或毫为单位存储整型避免浮点误差。若保留字符串比较时需转换为 float 或 Decimal。缓存域名交易数据变动不频繁可为相同查询条件设置短时缓存如 60 秒降低接口调用次数。安全API Key 不要泄露在客户端代码中。服务端调用时使用环境变量或在配置中心管理。代码接入示例Pythonimport requests import os API_KEY os.environ.get(APIZERO_API_KEY) BASE_URL https://v1.apizero.cn/api/domain-trade params { page: 1, pagesize: 50, max_price: 5000, suffix: .com } headers {X-API-Key: API_KEY} resp requests.get(BASE_URL, paramsparams, headersheaders) if resp.status_code 200: data resp.json() if data[code] 0: for domain in data[data][list]: print(f{domain[name]}: {domain[price]} 元 ({domain[sale_type]})) else: print(业务错误:, data[msg]) else: print(HTTP 错误:, resp.status_code)参考文档官方 API 文档https://apizero.cn/aidocs/domain-trade原始 Markdown 文档https://apizero.cn/aidocs/domain-trade/raw.md注如文档版本更新请以最新版本为准。