域名注册购买页预释放域名查询

1. 接口描述

接口请求域名： domain.tencentcloudapi.com 。

接口用于预释放页面查询

默认接口请求频率限制：20次/秒。

推荐使用 API Explorer

点击调试

API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	类型	描述
Action	是	String	公共参数，本接口取值：DescribePreReleaseList。
Version	是	String	公共参数，本接口取值：2018-08-08。
Region	否	String	公共参数，本接口不需要传递此参数。
Keywords	否	String	单独使用Keywords：使用域名关键词进行搜索 Keywords+DomainStart（true）：使用域名开头关键词进行搜索 Keywords+DomainEnd（true）：使用域名结尾关键词进行搜索 Keywords+DomainStart（true）+DomainEnd（true）：使用域名开头或结尾关键词进行搜索示例值：tencent.com
DomainStart	否	Boolean	是否以域名开头关键词进行搜索 true：是 false：否示例值：true
DomainEnd	否	Boolean	是否以域名结尾关键词进行搜索 true：是 false：否示例值：true
Sort	否	Integer	不同排序规则： 1：价格升序 2：价格降序 3：域名升序 4：结束时间升序 5：店铺推荐升序 6：结束时间降序 15: 创建时间升序其他：结束时间升序示例值：1
PriceStart	否	Float	起始价格示例值：100.00元
PriceEnd	否	Float	结束价格示例值：1000.00元
LengthStart	否	Integer	起始域名长度示例值：3
LengthEnd	否	Integer	结束域名长度示例值：4
PageNumber	否	Integer	页码（默认为1）示例值：1
PageSize	否	Integer	每页显示数（默认为20）示例值：20
Suffix.N	否	Array of Integer	后缀 1="com" 2="net" 4="biz" 6="info" 7="co" 9="cn" 10="com.cn" 11="wang" 12="vip" 13="cc" 14="net.cn" 15="org.cn" 16="top" 17="asia" 18="tv" 19="club" 20="shop" 21 ="中国" 23="online" 24="xyz" 25="网店" 26="网址" 27="在线" 28="ltd" 29="fans" 30="ren" 31="icu" 示例值：9
ClassOne	否	Integer	一级分类 1:"纯数字" 2:"单数字" 3:"双数字" 4:"三数字" 5:"四数字" 6:"五数字" 7:"六数字" 9:"单字母" 10:"双字母" 11:"三字母" 12:"四字母" 13:"五字母" 14:"单拼" 15:"双拼" 16:"三拼" 17:"杂米" 18:"两杂" 19:"三杂" 20:"四杂" 示例值：2
ClassTwo.N	否	Array of Integer	二级分类 13:"0开或带4" 14:"非0开不带4" 15:"不带0,4" 0:"非全声母" 6:"全声母" 16:"不带0,4" 32:"全声母" 5010:"CVCV" 示例值：5
ClassThree.N	否	Array of Integer	三级分类 111:"AAA" 401:"3A及以上" 402:"AA结尾" 1122:"AABB" 1123:"AABC" 1212:"ABAB" 1221:"ABBA" 1233:"ABCC" 501:"4A及以上" 502:"3A及以上" 503:"AAA开头" 504:"AAA结尾" 505:"AA开头" 506:"AA结尾" 507:"三顺子开头" 508:"三顺子结尾" 11223:"AABBC" 12233:"ABBCC" 601:"5A及以上" 602:"4A及以上" 603:"3A及以上" 604:"4A开头" 605:"4A结尾" 606:"AAA开头" 607:"AAA结尾" 608:"AA开头" 609:"AA结尾" 610:"ABAB开头" 611:"ABAB结尾" 612:"AABB开头" 613:"AABB结尾" 614:"四顺子开头" 615:"四顺子结尾" 616:"三顺子开头" 617:"三顺子结尾" 121212:"ABABAB" 112233:"AABBCC" 123123:"ABCABC" 211:"LNN" 221:"LLN" 121:"NLN" 212:"LNL" 122:"NLL" 1112:"NNNL" 2111:"LNNN" 1212:"NLNL" 2121:"LNLN" 1222:"NLLL" 2221:"LLLN" 1122:"NNLL" 2211:"LLNN" 31:"W结尾" 112:"AAB" 122:"ABB" 121:"ABA" 41:"W结尾" 1112:"AAAB" 1222:"ABBB" 1122:"AABB" 1212:"ABAB" 示例值：10
ClassFour.N	否	Array of Integer	四级分类 1:"仅含2种数字" 2:"仅含3种数字" 4:"仅含1种字母" 8:"仅含1种数字" 示例值：6
FilterStart	否	Boolean	是否以域名开头排除关键词进行搜索示例值：true
FilterEnd	否	Boolean	是否以域名结尾排除关键词进行搜索示例值：true
FilterWords	否	String	域名排除关键词单独使用FilterWords：使用排除关键词进行搜索 FilterWords+FilterStart（true）：使用域名开头排除关键词进行搜索 FilterWords+FilterEnd（true）：使用域名结尾排除关键词进行搜索 FilterWords+FilterStart（true）+FilterEnd（true）：使用域名开头或结尾排除关键词进行搜索示例值：tencent
TransType	否	Integer	交易类型（目前只支持10） 10: 预释放域名示例值：10
IsTop	否	Boolean	是否搜索白金域名（默认值为false）示例值：false
EndTimeSort	否	String	结束时间排序 desc:倒序 asc:正序示例值：desc
EndTime	否	String	结束时间（YYYY-MM-DD）示例值：2006-01-02

3. 输出参数

参数名称	类型	描述
TotalCount	Integer	数量示例值：10
PreReleaseList	Array of PreReleaseInfo	预释放列表示例值：[{"Domain":"pvpn.com","ReservationTime":"2025-04-25 16:38:51","RegTime":"2003-03-26 17:38:51","DelTime":"2025-05-26 16:38:51","CurrentPeople":8,"Price":198,"IsFollow":false,"IsAppoint":false,"BusinessId":"P0011744807158035431","IsDomainUser":false}]
RequestId	String	唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 请求成功示例

列表数据

输入示例

POST / HTTP/1.1
Host: domain.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribePreReleaseList
<公共请求参数>

{}

输出示例

{
    "Response": {
        "PreReleaseList": [
            {
                "BusinessId": "P0011703064185349649",
                "CurrentPeople": 1,
                "DelTime": "2024-01-16 00:00:00",
                "Domain": "099hq.net",
                "IsAppoint": false,
                "IsFollow": false,
                "Price": 102,
                "RegTime": "2020-01-01 00:00:00",
                "ReservationTime": "2023-12-31 07:32:05"
            },
            {
                "BusinessId": "P0011703067801554141",
                "CurrentPeople": 1,
                "DelTime": "2024-01-16 00:00:00",
                "Domain": "095hq.net",
                "IsAppoint": false,
                "IsFollow": false,
                "Price": 102,
                "RegTime": "2020-01-01 00:00:00",
                "ReservationTime": "2023-12-31 07:32:05"
            },
            {
                "BusinessId": "P0011702284530637838",
                "CurrentPeople": 2,
                "DelTime": "2024-01-16 00:00:00",
                "Domain": "091hq.net",
                "IsAppoint": false,
                "IsFollow": false,
                "Price": 102,
                "RegTime": "2020-01-01 00:00:00",
                "ReservationTime": "2023-12-31 07:32:05"
            }
        ],
        "RequestId": "543393c3-28c3-4de0-8535-1256fe004410",
        "TotalCount": 3
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

Tencent Cloud SDK 3.0 for Python: GitHub, Gitee
Tencent Cloud SDK 3.0 for Java: GitHub, Gitee
Tencent Cloud SDK 3.0 for PHP: GitHub, Gitee
Tencent Cloud SDK 3.0 for Go: GitHub, Gitee
Tencent Cloud SDK 3.0 for Node.js: GitHub, Gitee
Tencent Cloud SDK 3.0 for .NET: GitHub, Gitee
Tencent Cloud SDK 3.0 for C++: GitHub, Gitee
Tencent Cloud SDK 3.0 for Ruby: GitHub, Gitee

命令行工具

Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
FailedOperation.DescribePreReleaseList	获取列表异常

购买页预释放域名查询

本页目录：