GET 免费 缓存 600s 正常运行
热门商品排行榜
**上游鉴权**:Query 参数、Header(X-API-Key)、Bear […]
GET
https://demo.gsx.hk/wp-json/apihub/v1/call/278
i
免费接口:在线调试与程序调用均须填写/携带站点 Key 后使用,不提供匿名试用。Key 在「我的控制台」获取。
接口说明
**上游鉴权**:Query 参数、Header(X-API-Key)、Bearer Token
**频率限制**:30/MIN
**上游状态**:正常
> 数据来源:https://xiaoapi.cn/detail/78
调用统计
1
累计调用
0
今日调用
100%
成功率
762ms
平均耗时
近 30 天调用趋势
10/1610/3111/14
请求参数 共 3 个
| 参数名 | 必填 | 默认值 | 说明 |
|---|---|---|---|
category
|
必填 | cell_phone |
商品或产品类型分类,仅可为: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(按摩椅) |
type
|
— | — | 榜单类型:product=产品榜(默认) / brand=品牌榜 |
limit
|
— | — | 返回条数:1-100;0或缺省=全部(通常50条) |
鉴权参数:
在线调试与程序调用均必须携带站点 Key,以
key
参数传入(Query 或 POST 字段均可),例如 ?key=ah_xxxxxxxx。
Key 在「我的控制台」获取,切勿写进前端代码或提交到公开仓库。 调用示例
BASH
curl -X GET "https://demo.gsx.hk/wp-json/apihub/v1/call/278?key=YOUR_SITE_KEY&category=cell_phone&type=YOUR_TYPE&limit=YOUR_LIMIT" \ -H "Accept: application/json"
PHP
<?php
$url = 'https://demo.gsx.hk/wp-json/apihub/v1/call/278?key=YOUR_SITE_KEY&category=cell_phone&type=YOUR_TYPE&limit=YOUR_LIMIT';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 20,
CURLOPT_HTTPHEADER => ['Accept: application/json'],
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);
JAVASCRIPT
const params = {"key":"YOUR_SITE_KEY","category":"cell_phone","type":"YOUR_TYPE","limit":"YOUR_LIMIT"};
const url = 'https://demo.gsx.hk/wp-json/apihub/v1/call/278?' + new URLSearchParams(params);
const res = await fetch(url, {
method: 'GET',
headers: { 'Accept': 'application/json' }
});
const data = await res.json();
console.log(data);
PYTHON
import requests
url = "https://demo.gsx.hk/wp-json/apihub/v1/call/278"
params = {
"key": "YOUR_SITE_KEY",
"category": "cell_phone",
"type": "YOUR_TYPE",
"limit": "YOUR_LIMIT",
}
resp = requests.get(url, params=params, timeout=20)
print(resp.json())
返回示例
网关会统一包装返回结果,业务数据在 data 字段内:
JSON
{
"ok": true,
"http_code": 200,
"cost_ms": 186,
"credits": 0,
"currency": "points",
"cached": false,
"data": {
"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"
}
}
补充说明
上游鉴权:Query 参数、Header(X-API-Key)、Bearer Token
频率限制:30/MIN
上游状态:正常
> 数据来源:https://xiaoapi.cn/detail/78
网关错误码
| HTTP | code | 说明 |
|---|---|---|
| 400 | missing_param | 缺少必填参数,message 中会给出参数名 |
| 401 | invalid_key / need_login | 站点 Key 无效或未登录 |
| 402 | no_balance | 余额或积分不足,请充值后再调用 |
| 404 | api_not_found | 接口不存在或已下线 |
| 429 | rate_limited | 超出今日调用频率上限 |
| 502 | upstream_error | 接口服务不可达或响应异常,本次不扣费 |