热搜趋势解读：trend 字段 up/down/same 与 rise 取值怎么用？
# 热搜趋势解读：trend 字段 up/down/same 与 rise 取值怎么用？
> 接口：网络搜索热词排行（apiCode=313，接入点 313-2） · 免费服务 · 返回格式 JSON · 适用人群：中级开发者、数据分析师 · 阅读时间：约 5 分钟
## 核心要点
- `trend` 表示热搜词相对上一统计周期的走势：`升 / 降 / 持平`。
- **文档不一致**：字段表写 `up`=升 / `down`=降 / `same`=持平，但返回示例出现 `"trend":"rise"`。真实接口疑似返回 `rise/down/same`。
- 正确做法：代码同时兼容 `rise/up`→升、`down`→降、`same`→持平，不要写死一种。
## Why：这个字段为什么值得单独写一篇
趋势字段是做"追热点""热度看板"的核心信号。但如果代码只按文档字段表的 `up/down/same` 判断，遇到真实返回的 `rise` 就会全部落空、界面一片空白。这一篇把坑讲清，给你一套兼容写法。
## What：trend 在返回里的位置
```json
{
"showapi_res_body": {
"list": [
{ "level": "22244", "name": "驴友瀑降不幸身亡", "num": "1", "trend": "rise" }
],
"ret_code": 0
}
}
```
`list[].trend` 为 String。字段表释义：up=升、down=降低、same=持平。
## How：兼容两种取值的写法
### Python
```python
def trend_label(trend):
return {
"rise": "升", "up": "升",
"down": "降",
"same": "持平",
}.get(str(trend), str(trend))
# 用法
for item in get_hotwords("game"):
print(item.get("name"), "→", trend_label(item.get("trend")))
```
### JavaScript
```javascript
function trendLabel(trend) {
const map = { rise: "升", up: "升", down: "降", same: "持平" };
return map[String(trend)] ?? String(trend);
}
```
### cURL（先看真实返回）
```bash
curl -X POST "https://route.showapi.com/313-2?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded" \
-d "tab=game&category=&country="
```
## 返回示例与解析
| 观察到的 `trend` 值 | 字段表说法 | 建议显示 |
|--------------------|-----------|---------|
| `rise` | 未直接列出（示例实际出现） | 升 ↑ |
| `up` | 升 | 升 ↑ |
| `down` | 降低 | 降 ↓ |
| `same` | 持平 | 持平 → |
## 进阶 / 边界（需修正项）
- **文档字段表与返回示例冲突**：这是本接口实测发现的最明显文档问题。字段表说取值是 `up/down/same`，但返回示例里是 `rise`。生产代码务必兼容两种，否则按字段表写死会漏判。
- 接口未提供"预测"数据，`trend` 只是相对上一周期的标记，不要展示或解读为"明天会更热"。
- 若上游修复为统一取值，只需更新上面的映射表即可，业务逻辑不变。
## FAQ
**Q1：到底该按 up 还是 rise 判断？**
A1：两个都兼容。用本文的映射函数，`rise` 和 `up` 都会映射成"升"， whichever 上游返回都能正确显示。
**Q2：为什么文档自己前后不一致？**
A2：属文档编写疏漏（字段表与示例未对齐）。已作为需修正项反馈，但接口行为以实际返回为准，代码以兼容为先。
**Q3：trend 为空或缺失怎么办？**
A3：映射函数对未知值原样返回，建议前端对未知/缺失值显示"—"，不要报错中断。
**Q4：能用 trend 给内容排序吗？**
A4：可以辅助，但主排序仍建议用 `num`（排名）；`trend` 用来在并列或筛选时加权（优先上升词）。
**Q5：same 表示完全没变化吗？**
A5：文档标注"持平"，即相对上一周期无显著升降；具体统计口径以平台为准，不要过度解读。
## 相关能力 / 下一步阅读
- [网络搜索热词排行返回字段全解：name/num/level/trend 一文读懂](https://www.showapi.com/guides/hotword-response-fields-313)
- [新媒体运营如何用网络搜索热词排行做选题与追热点？](https://www.showapi.com/guides/hotword-content-ops-313)
- [搭建实时热搜看板：网络搜索热词排行 + 定时拉取的完整设计](https://www.showapi.com/guides/hotword-dashboard-313)
- **本系列共 12 篇**：查看[网络搜索热词排行开发指南总目录](https://www.showapi.com/guides/hotword-guides-313)
