/ 接口详情
/ 接口详情
·
网络工具
GET / POST
热门商品排行榜
查询相关热门商品排行榜，获取最具性价比的商品价格及信息，包含：手机、电脑、显卡、冰箱、电视等
调用 27 次
免费
KEY 必填
QPM 30/MIN
Query 参数、Header(X-API-Key)、Bearer Token
接口信息
GET / POST
xiaoapi.cn/v1/top_rank.php
方法
GET / POST
分类
网络工具
计费
免费
KEY
KEY 必填
调用
27
QPM
30/MIN
鉴权
Query 参数、Header(X-API-Key)、Bearer Token
作者
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| key | string | 是 | 接口调用密钥 | |
| category | string | 是 | 商品或产品类型分类，仅可为：cell_phone（手机）、notebook（笔记本电脑）、ultrabook（超极本）、tablet（平板电脑）、motherboard（主板）、graphics_card（显卡）、desktop（台式电脑）、cpu（CPU）、portable_disk（移动硬盘）、lcd（液晶显示器）、digital_camera（数码相机）、digital_tv（平板电视）、digital_camcorder（数码摄像机）、lens（镜头）、air_conditioner（空调）、washer（洗衣机）、refrigerator（冰箱）、air_purifier（空气净化器）、smart_watch（智能手表）、rc_vehicle（遥控/电动车）、massage_chair（按摩椅） | cell_phone |
| type | string | 否 | 榜单类型：product=产品榜(默认) / brand=品牌榜 | |
| limit | integer | 否 | 返回条数：1-100；0或缺省=全部(通常50条) |
[
{
"name": "key",
"type": "string",
"required": true,
"description": "接口调用密钥",
"example": ""
},
{
"name": "category",
"type": "string",
"required": true,
"description": "商品或产品类型分类，仅可为：cell_phone（手机）、notebook（笔记本电脑）、ultrabook（超极本）、tablet（平板电脑）、motherboard（主板）、graphics_card（显卡）、desktop（台式电脑）、cpu（CPU）、portable_disk（移动硬盘）、lcd（液晶显示器）、digital_camera（数码相机）、digital_tv（平板电视）、digital_camcorder（数码摄像机）、lens（镜头）、air_conditioner（空调）、washer（洗衣机）、refrigerator（冰箱）、air_purifier（空气净化器）、smart_watch（智能手表）、rc_vehicle（遥控/电动车）、massage_chair（按摩椅）",
"example": "cell_phone"
},
{
"name": "type",
"type": "string",
"required": false,
"description": "榜单类型：product=产品榜(默认) / brand=品牌榜",
"example": ""
},
{
"name": "limit",
"type": "integer",
"required": false,
"description": "返回条数：1-100；0或缺省=全部(通常50条)",
"example": ""
}
]
{
"openapi": "3.1.1",
"info": {
"title": "热门商品排行榜",
"description": "查询相关热门商品排行榜，获取最具性价比的商品价格及信息，包含：手机、电脑、显卡、冰箱、电视等",
"version": "1.0.0"
},
"paths": {
"/v1/top_rank.php": {
"get": {
"summary": "热门商品排行榜",
"description": "查询相关热门商品排行榜，获取最具性价比的商品价格及信息，包含：手机、电脑、显卡、冰箱、电视等",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"name": "category",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "cell_phone"
},
"description": "商品或产品类型分类，仅可为：cell_phone（手机）、notebook（笔记本电脑）、ultrabook（超极本）、tablet（平板电脑）、motherboard（主板）、graphics_card（显卡）、desktop（台式电脑）、cpu（CPU）、portable_disk（移动硬盘）、lcd（液晶显示器）、digital_camera（数码相机）、digital_tv（平板电视）、digital_camcorder（数码摄像机）、lens（镜头）、air_conditioner（空调）、washer（洗衣机）、refrigerator（冰箱）、air_purifier（空气净化器）、smart_watch（智能手表）、rc_vehicle（遥控/电动车）、massage_chair（按摩椅）"
},
{
"name": "type",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "榜单类型：product=产品榜(默认) / brand=品牌榜"
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "返回条数：1-100；0或缺省=全部(通常50条)"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
}
}
},
"post": {
"summary": "热门商品排行榜",
"description": "查询相关热门商品排行榜，获取最具性价比的商品价格及信息，包含：手机、电脑、显卡、冰箱、电视等",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"name": "category",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "cell_phone"
},
"description": "商品或产品类型分类，仅可为：cell_phone（手机）、notebook（笔记本电脑）、ultrabook（超极本）、tablet（平板电脑）、motherboard（主板）、graphics_card（显卡）、desktop（台式电脑）、cpu（CPU）、portable_disk（移动硬盘）、lcd（液晶显示器）、digital_camera（数码相机）、digital_tv（平板电视）、digital_camcorder（数码摄像机）、lens（镜头）、air_conditioner（空调）、washer（洗衣机）、refrigerator（冰箱）、air_purifier（空气净化器）、smart_watch（智能手表）、rc_vehicle（遥控/电动车）、massage_chair（按摩椅）"
},
{
"name": "type",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "榜单类型：product=产品榜(默认) / brand=品牌榜"
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "返回条数：1-100；0或缺省=全部(通常50条)"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
}
}
}
}
},
"servers": [
{
"url": "https://xiaoapi.cn",
"description": "当前访问入口（https）"
}
]
}
返回示例
{
"code": 200,
"msg": "ok",
"data": [
{
"rank": 1,
"name": "vivo X500 Pro Max(12GB/256GB)",
"price": "￥6999",
"score": "9.8",
"heat": "100"
},
{
"rank": 2,
"name": "华为Pura X View(12GB/256GB)",
"price": "￥5999",
"score": "10.0",
"heat": "99"
},
{
"rank": 3,
"name": "荣耀X80 Pro Max(8GB/128GB)",
"price": "￥1999",
"score": "9.9",
"heat": "38"
},
{
"rank": 4,
"name": "OPPO Find X9 Pro(12GB/256GB)",
"price": "￥5299",
"score": "9.9",
"heat": "34"
},
{
"rank": 5,
"name": "Apple（苹果）iPhone 18",
"price": "概念产品",
"score": null,
"heat": "29"
},
{
"rank": 6,
"name": "vivo X Fold6(12GB/256GB)",
"price": "￥7999",
"score": "10.0",
"heat": "27"
},
{
"rank": 7,
"name": "HUAWEI Mate 80(12GB/256GB)",
"price": "￥4699",
"score": "9.9",
"heat": "25"
},
{
"rank": 8,
"name": "华为Pura X Max(12GB/512GB)",
"price": "￥11999",
"score": "9.9",
"heat": "21"
},
{
"rank": 9,
"name": "vivo X300(12GB/256GB)",
"price": "￥4399",
"score": "10.0",
"heat": "20"
},
{
"rank": 10,
"name": "苹果iPhone 17 Pro Max（256GB）",
"price": "￥9999",
"score": "10.0",
"heat": "20"
},
{
"rank": 11,
"name": "小米18 Fold(12GB/256GB)",
"price": "￥10999",
"score": "9.8",
"heat": "20"
},
{
"rank": 12,
"name": "HUAWEI Mate 80 Pro Max(16GB/512GB)",
"price": "￥7999",
"score": "10.0",
"heat": "17"
},
{
"rank": 13,
"name": "荣耀Magic8 Pro(12GB/256GB)",
"price": "￥5699",
"score": "10.0",
"heat": "15"
},
{
"rank": 14,
"name": "华为畅享90 Pro Max 128GB",
"price": "￥1699",
"score": "9.9",
"heat": "15"
},
{
"rank": 15,
"name": "华为nova 16（256GB）",
"price": "￥2999",
"score": "9.9",
"heat": "12"
},
{
"rank": 16,
"name": "小米17 Ultra(12GB/512GB)",
"price": "￥6999",
"score": "9.9",
"heat": "11"
},
{
"rank": 17,
"name": "HUAWEI Pura X(12GB/256GB)",
"price": "￥7499",
"score": "9.7",
"heat": "11"
},
{
"rank": 18,
"name": "荣耀Power2(12GB/256GB)",
"price": "￥2699",
"score": "10.0",
"heat": "10"
},
{
"rank": 19,
"name": "iQOO Z11S(8GB/128GB)",
"price": "￥1799",
"score": "0.0",
"heat": "10"
},
{
"rank": 20,
"name": "苹果iPhone 17（256GB）",
"price": "￥5999",
"score": "10.0",
"heat": "9"
},
{
"rank": 21,
"name": "苹果iPhone 18 Pro Max（256GB）",
"price": "￥10999",
"score": "9.8",
"heat": "9"
},
{
"rank": 22,
"name": "苹果iPhone 17 Pro（256GB）",
"price": "￥8999",
"score": "9.9",
"heat": "9"
},
{
"rank": 23,
"name": "苹果iPhone 18 Pro（256GB）",
"price": "￥9999",
"score": "10.0",
"heat": "9"
},
{
"rank": 24,
"name": "一加15（12GB/256GB）",
"price": "￥3999",
"score": "10.0",
"heat": "9"
},
{
"rank": 25,
"name": "荣耀500 Pro(12GB/256GB)",
"price": "￥3599",
"score": "10.0",
"heat": "9"
},
{
"rank": 26,
"name": "Apple（苹果）iPhone Air 256GB",
"price": "￥7999",
"score": "9.9",
"heat": "9"
},
{
"rank": 27,
"name": "苹果iPhone Duo（256GB）",
"price": "￥15999",
"score": "0.0",
"heat": "9"
},
{
"rank": 28,
"name": "OPPO A7 Pro Max(8GB/128GB)",
"price": "￥2199",
"score": null,
"heat": "8"
},
{
"rank": 29,
"name": "vivo X300 Ultra(12GB/256GB)",
"price": "￥6999",
"score": "9.9",
"heat": "8"
},
{
"rank": 30,
"name": "小米17 Pro Max（12GB/512GB）",
"price": "￥5999",
"score": "10.0",
"heat": "8"
},
{
"rank": 31,
"name": "荣耀X70(8GB/128GB)",
"price": "￥1399",
"score": "9.8",
"heat": "7"
},
{
"rank": 32,
"name": "华为Mate XT 非凡大师(16GB/512GB)",
"price": "￥21999",
"score": "9.7",
"heat": "6"
},
{
"rank": 33,
"name": "荣耀Magic8 Pro Air(12GB/256GB)",
"price": "￥4999",
"score": "9.9",
"heat": "6"
},
{
"rank": 34,
"name": "vivo Y600 Pro（8GB/256GB）",
"price": "￥1999",
"score": "10.0",
"heat": "6"
},
{
"rank": 35,
"name": "iQOO Z11(8GB/256GB)",
"price": "￥1999",
"score": "9.9",
"heat": "6"
},
{
"rank": 36,
"name": "荣耀Magic8(12GB/256GB)",
"price": "￥4499",
"score": "9.9",
"heat": "6"
},
{
"rank": 37,
"name": "华为Pura X View(12GB/512GB)",
"price": "￥6999",
"score": null,
"heat": "6"
},
{
"rank": 38,
"name": "华为Mate XT 2 非凡大师（16GB/512GB）",
"price": "￥21999",
"score": null,
"heat": "6"
},
{
"rank": 39,
"name": "HUAWEI Mate 80 Pro(12GB/512GB)",
"price": "￥6499",
"score": "10.0",
"heat": "6"
},
{
"rank": 40,
"name": "vivo S60（12GB/256GB）",
"price": "￥3599",
"score": "9.9",
"heat": "5"
},
{
"rank": 41,
"name": "Redmi K100 Pro（12GB/256GB）",
"price": "￥3699",
"score": null,
"heat": "5"
},
{
"rank": 42,
"name": "一加Ace 6T(12GB/256GB)",
"price": "￥2599",
"score": "10.0",
"heat": "5"
},
{
"rank": 43,
"name": "OPPO Find X9(12GB/256GB)",
"price": "￥4399",
"score": "9.9",
"heat": "5"
},
{
"rank": 44,
"name": "一加Turbo 6(12GB/256GB)",
"price": "￥2299",
"score": "9.9",
"heat": "5"
},
{
"rank": 45,
"name": "HUAWEI Mate 70 Pro(12GB/512GB)",
"price": "￥6999",
"score": "9.9",
"heat": "5"
},
{
"rank": 46,
"name": "华为nova 16 SE（256GB）",
"price": "￥2699",
"score": null,
"heat": "5"
},
{
"rank": 47,
"name": "荣耀600 Pro(12GB/256GB)",
"price": "￥3899",
"score": "9.6",
"heat": "5"
},
{
"rank": 48,
"name": "HUAWEI Mate 60 Pro（12GB/256GB）",
"price": "￥6499",
"score": "9.7",
"heat": "5"
},
{
"rank": 49,
"name": "荣耀500(12GB/256GB)",
"price": "￥2699",
"score": "10.0",
"heat": "4"
},
{
"rank": 50,
"name": "OPPO Find X9 Ultra(12GB/256GB)",
"price": "￥7499",
"score": "9.9",
"heat": "4"
}
],
"category": "cell_phone",
"category_name": "手机",
"type": "product",
"cached": true,
"count": 50,
"fetched_at": "2026-10-31 16:25:37"
}
详细文档
暂无详细文档
快速上手
暂无代码示例。管理员可在后台用 AI 生成或手动编写。
在线测试
请求地址
xiaoapi.cn/v1/top_rank.php
Method
参数
Response
// 结果将在此处显示
接口反馈
推荐接口
服务免责声明
生效日期：2026年7月22日
欢迎使用 xiaoapi.cn（以下简称"本平台"）。在使用本平台提供的 API 服务（以下简称"本服务"）前，请务必仔细阅读并充分理解本免责声明。您以任何方式调用、访问或使用本服务，即视为您已阅读、理解并同意接受本声明的全部内容。
一、声明目的
本平台作为 API 技术服务的提供方，仅提供技术接口与数据分发服务。本声明的目的在于明确平台与用户之间的责任边界，督促用户合法、合规地使用本服务，防范违法违规行为的发生。
二、用户责任与合规承诺
- 用户应为自身的一切调用行为承担全部责任，包括但不限于调用方式、调用目的、数据使用、结果传播及由此产生的全部后果。
- 用户承诺在使用本服务过程中，严格遵守中华人民共和国法律法规以及所在国家/地区的适用法律，包括但不限于《网络安全法》《数据安全法》《个人信息保护法》《著作权法》《刑法》及相关司法解释。
- 用户承诺不以任何方式利用本服务从事损害国家利益、社会公共利益、他人合法权益的活动。
三、禁止性行为
用户在使用本服务时，明确禁止从事以下行为：
- 利用本服务制作、复制、传播、存储任何法律法规禁止的内容，包括但不限于色情低俗、赌博、诈骗、暴力恐怖、毒品、虚假谣言等信息；
- 利用本服务从事黑客攻击、入侵、破坏、干扰、非法获取他人数据或系统权限等行为；
- 利用本服务侵犯他人知识产权、商业秘密、个人隐私或其他合法权益；
- 利用本服务实施网络诈骗、钓鱼、洗钱、电信网络诈骗等违法犯罪活动；
- 绕过本平台或第三方平台的安全机制、访问控制、收费机制或版权保护措施；
- 未经授权将本服务用于商业转售、批量恶意调用、恶意抓取、骚扰性推送等行为；
- 其他违反法律法规或本平台服务协议的行为。
四、第三方内容与数据免责
- 本服务所分发、转发或返回的部分数据、内容可能来源于第三方接口、公开网络或其他合作方，本平台对其真实性、准确性、合法性不作出任何保证。
- 因第三方内容、第三方接口异常、第三方版权纠纷或第三方平台政策变化所引发的任何争议、损失，由相关第三方承担责任，本平台不承担由此产生的责任，但将依法配合权利人和主管部门进行处理。
五、平台免责范围
在法律法规允许的最大范围内，本平台对以下情形不承担责任：
- 用户因违规、违法使用本服务所产生的全部法律责任与后果，均由用户自行承担；
- 因用户操作不当、接口误用、参数错误、网络环境异常等原因造成的损失；
- 因不可抗力（包括但不限于自然灾害、政府行为、电力故障、网络中断、第三方服务故障）导致的服务中断、延迟或数据丢失；
- 因本平台进行必要的系统维护、升级、调整而导致的服务临时不可用；
- 用户之间、用户与第三方之间因使用本服务产生的纠纷。
六、违规处理与账号管理
- 本平台有权对用户的调用行为进行监测与审查。
- 一经发现用户存在违法、违规或违反本声明的行为，本平台有权视情节轻重采取警告、限制调用、暂停服务、封禁账号等措施，并保留向有关主管部门举报、移交司法机关处理的权利。
- 因用户违规行为导致本平台被第三方索赔、被主管部门处罚或遭受其他损失的，用户应承担全部赔偿责任。
七、赔偿条款
因用户违反本声明或相关法律法规，导致本平台及其关联方、合作方遭受任何损失（包括但不限于赔偿款、罚款、律师费、诉讼费等），用户同意向本平台及相关方承担全部赔偿责任。
八、知识产权
- 本平台自身的商标、标识、界面设计、技术代码等知识产权归本平台所有，未经许可不得擅自使用。
- 用户不得利用本服务对第三方知识产权进行侵犯；因用户侵权行为引发的纠纷由用户自行负责。
九、法律适用与争议解决
- 本声明的订立、解释、变更及争议解决均适用中华人民共和国法律。
- 因本声明或本服务产生的争议，双方应友好协商解决；协商不成的，任何一方可向本平台运营方所在地有管辖权的人民法院提起诉讼。
十、声明变更
本平台有权根据法律法规变化、业务调整或监管要求，随时修改本声明。修改后的声明将在本页面公布，自公布之日起生效。您继续使用本服务，即视为接受更新后的声明。
十一、联系我们
如您对本声明有任何疑问，或发现他人存在违规使用本服务的行为，欢迎通过本平台公示的联系方式与我们联系，我们将及时处理。