适用场景与接口定位域名交易市场的公开数据对以下几类开发者有直接价值站长/域名投资人按用量说明、长度、后缀筛选目标域名快速缩小选品范围。行业研究拉取一段时间内的交易记录分析热门后缀分布、用量说明区间走势。估值参考结合同后缀、同长度的成交用量说明辅助判断某个域名的合理估值区间。该接口定位为只读的数据查询接口返回的是 EDNS 域名交易市场的公开挂牌/成交信息。它不承担下单、竞价、支付等交易链路接入前应明确这一点接口只负责数据不负责业务闭环。接口能力边界在写代码之前先确认几个事实项目说明请求方法GET请求地址https://v1.apizero.cn/api/domain-trade分类金融数据QPS 上限5 / s鉴权方式HeaderX-API-Key数据返回JSON 数组格式的响应体QPS 5/s 意味着单机并发拉取需要做限速。如果你的任务需要遍历全部数据页建议每次请求间隔 200ms 以上避免触发限流。鉴权方式接口通过请求头X-API-Key传递 API Key例如curl -sS \ -X GET \ -H X-API-Key: $APIZERO_API_KEY \ https://v1.apizero.cn/api/domain-trade?page1pagesize10$APIZERO_API_KEY是环境变量占位实际调用时请替换为你自己的 Key。不要把 Key 硬编码到前端页面或公开仓库中。Query 参数逐个拆解接口共支持 6 个查询参数全部非必填。参数之间是**叠加过滤AND**关系即同时传入多个参数时返回的数据要同时满足所有条件。page类型number默认值1语义页码注意点页码从 1 开始。如果传 0 或负数接口行为未在文档中明确稳妥做法是在业务层拦截非法值。pagesize类型number默认值50上限100语义每页返回的域名记录数这里有一个容易忽略的细节pagesize 的合法范围是 1 ≤ pagesize ≤ 100。传 0 或大于 100 的值接口可能拒绝或按上限截断。为了行为可控建议在构造请求前先做一次入参归一化pagesize max(1, min(pagesize, 100))max_price类型number语义最高用量说明元过滤方向只返回用量说明 ≤max_price的记录用量说明字段在响应中是字符串类型如5000但入参是数字类型。构造筛选条件时不要把max_price写成带单位的字符串也不要传小数位数过多的浮点数。建议以整数元为单位。max_length类型number语义域名最大长度这个参数需要特别留意长度计算的基准是什么是否包含后缀例如max_length8时abcdefg.com是算 7 个字符还是 11 个字符不同数据源的口径可能不同建议在接入前通过文档或少量抽样请求确认口径。若文档未明确默认按域名主标签不含点号和后缀长度理解但生产环境应以上游实际行为为准。suffix类型string语义后缀过滤传值时带上点号例如.com、.net。如果你用com这种无点号的写法可能匹配不到预期结果。建议在请求前做一次格式化suffix suffix.strip().lower() if not suffix.startswith(.): suffix . suffixsale_type类型string语义交易类型常见的交易类型包括一口价、竞价、拍卖等具体枚举值以文档为准。这是一个精确匹配参数不是模糊搜索传值时需要与数据源使用的文案完全一致。请求示例基础 curl拉取第一页 20 条数据curl -sS \ -X GET \ -H X-API-Key: $APIZERO_API_KEY \ https://v1.apizero.cn/api/domain-trade?page1pagesize20组合筛选 curl筛选用量说明不超过 200、长度不超过 6 位的.com域名curl -sS \ -X GET \ -H X-API-Key: $APIZERO_API_KEY \ https://v1.apizero.cn/api/domain-trade?page1pagesize50max_price2000max_length6suffix.comPython 请求模板import requests API_URL https://v1.apizero.cn/api/domain-trade def fetch_domain_trade(api_key: str, params_pack: dict) - dict: headers {X-API-Key: api_key} resp requests.get(API_URL, headersheaders, paramsparams_pack, timeout10) resp.raise_for_status() return resp.json() if __name__ __main__: params { page: 1, pagesize: 50, max_price: 5000, max_length: 8, suffix: .com, sale_type: 一口价, } result fetch_domain_trade(YOUR_API_KEY, params) print(result)timeout10是超时兜底避免网络异常时请求线程被长时间挂起。响应结构解读接口的响应示例结构如下{ code: 0, msg: 成功, data: { count: 50, current_page: 1, total_pages: 1234, list: [ { name: abc.com, price: 5000, sale_type: 一口价 } ] } }顶层字段字段类型含义codenumber业务状态码0 表示成功msgstring状态描述dataobject业务数据体data 对象字段类型说明countnumber当前页实际返回的记录条数current_pagenumber当前页码total_pagesnumber总页数listarray域名记录数组list 内的域名对象字段类型说明namestring域名如abc.compricestring用量说明元字符串类型sale_typestring交易类型如一口价注意price是字符串而不是数字。如果你需要对用量说明做排序或区间统计先做类型转换price_num float(item[price])分页遍历的坑分页遍历最容易踩的坑是用count判断是否还有下一页。实际上count表示当前页的记录数当最后一页数据不满一页时count pagesize可以辅助判断结束但更可靠的终止条件是current_page total_pages。推荐的分页遍历逻辑page 1 while True: params {page: page, pagesize: 50} payload fetch_domain_trade(api_key, params) data payload[data] # 业务处理 for item in data[list]: process_domain(item) if page data[total_pages]: break page 1 time.sleep(0.3) # QPS 限速兜底这个写法的好处是不依赖count的边界行为而是以服务端给出的total_pages作为遍历终点语义清晰且不容易死循环。另一个建议如果只需要最新一页的数据不要为了“保险”而强制翻完所有页。这既浪费配额也容易触发限流。常见错误排查401 鉴权失败现象接口返回 401 或提示非法 Key排查确认X-API-Key的拼写是否正确确认环境变量$APIZERO_API_KEY是否已导出确认 Key 没有被误放进 Query 参数中业务 code 非 0现象HTTP 200但响应中的code不等于 0排查逐项核对每个 Query 参数的类型是否符合文档pagesize是否超过 100max_price是否为负数suffix是否带了点号数据与预期不符现象请求成功但过滤结果看起来不对排查max_length的长度口径是否包含后缀sale_type的枚举文案是否与文档完全一致是否同时传了多个参数且它们之间有业务上的矛盾如既要求低价又要求超短域名限流现象请求偶尔超时或返回限流提示排查检查本地是否有并发循环请求QPS 是否超过 5/s。建议在代码中加入节流控制或请求间隔。工程化注意事项参数校验前置不要把上游接口当成校验器。在业务层提前拦截非法参数def build_domain_trade_params( page: int 1, pagesize: int 50, max_price: int | None None, max_length: int | None None, suffix: str | None None, sale_type: str | None None, ) - dict: if page 1: raise ValueError(page must be 1) if not (1 pagesize 100): pagesize 50 params {page: page, pagesize: pagesize} if max_price is not None: if max_price 0: raise ValueError(max_price must be 0) params[max_price] int(max_price) if max_length is not None: if max_length 1: raise ValueError(max_length must be 1) params[max_length] int(max_length) if suffix: suffix suffix.strip().lower() if not suffix.startswith(.): suffix . suffix params[suffix] suffix if sale_type: params[sale_type] sale_type return params把响应封装成领域模型响应中的price是字符串直接用于计算容易出问题。建议在数据入口统一转换dataclass class DomainTrade: name: str price: float sale_type: str def parse_domain_item(raw: dict) - DomainTrade: return DomainTrade( nameraw[name], pricefloat(raw[price]), sale_typeraw[sale_type], )用环境变量管理 Key不要把 Key 写在代码仓库里。建议使用.env文件或 CI/CD 的 Secret 管理export APIZERO_API_KEYyour_key_here日志与监控建议记录以下信息便于线上排查请求的完整 URLKey 打码响应状态码与业务 code请求耗时当前页与总页数小结域名交易市场接口整体不复杂核心价值在于Query 参数的精确组合和分页遍历的正确终止。接入时把参数校验前置、遍历逻辑按total_pages收敛、用量说明字段统一转浮点可以避开绝大多数使用上的坑。长度筛选的口径和交易类型枚举值建议以最新文档为准必要时通过小批量请求验证行为。参考文档接口文档页https://apizero.cn/aidocs/domain-trade原始文档https://apizero.cn/aidocs/domain-trade/raw.md