---
document_id: agent.collection.task.douyin_hot_search_v1
schema_version: 2
parent_document_id: agent.querying
section: querying
---

<!-- Generated by scripts.build_agent_guide; do not edit. -->

# Hot search board / 热搜榜

Fetch the current Douyin hot-search board. This is a board, not a search: to find videos by keyword use douyin_search_videos_v1.

取抖音当前热搜榜。这是榜单不是搜索,要按关键词找视频用 douyin_search_videos_v1。

Task / 任务: `douyin_hot_search_v1`
Platform / 平台: Douyin / 抖音
Billing / 计费: 3 Credits per successful task / 每个成功任务 3 Credits
Estimate / 估价: call `estimate_collection`; start directly when `approval_required=false`, otherwise obtain approval for `upper_bound_credits`.
估价：调用 `estimate_collection`；`approval_required=false` 时直接启动，否则请用户确认 `upper_bound_credits`。

## Limitations / 限制

- 返回实时榜单,不接受任何筛选参数。
- 榜单项是话题词,不是视频;拿到词后需自行搜索。

## Inputs / 输入


## Minimal call / 最小调用

`estimate_collection`

```json
{
  "task_query": "查看抖音当前的热搜榜",
  "task_code": "douyin_hot_search_v1",
  "input": {}
}
```


## Result and pagination / 结果与分页

- mode=none

Only the fields listed below are part of the stable result contract. /
只有下方列出的字段属于稳定结果契约。

## Result fields / 结果字段

- `meta.request_id` — type=string; Asklear request identifier for tracing. / 用于追踪的 Asklear 请求 ID。
- `meta.api_name` — type=string; Executed collection operation name. / 实际执行的采集操作名称。
- `meta.latency_ms` — type=integer; Collection execution latency in milliseconds. / 采集执行耗时（毫秒）。
- `meta.credits_charged` — type=integer; Asklear user-side Credits settled for this task after completion. / 任务完成后 Asklear 用户侧实际结算的 Credits。
- `data.items` — type=array<object>; Projected public items for this task. / 本任务投影后的公开条目。
- `data.item_count` — type=integer; Number of returned items. / 本次返回的条目数。
- `data.items[].word` — type=scalar|null; Word, when available. / 词（如有）。
- `data.items[].hot_value` — type=scalar|null; Hot value, when available. / 热度值（如有）。
- `data.items[].view_count` — type=scalar|null; View count, when available. / 浏览数（如有）。
- `data.items[].discuss_video_count` — type=scalar|null; Discuss video count, when available. / 讨论视频数（如有）。
- `data.items[].sentence_id` — type=scalar|null; Sentence id, when available. / 语句ID（如有）。

Use `list_collection_tasks` as the runtime authority, then `describe_collection_task` for one task's full input contract, examples and limits. Collection access is entitlement-gated. /
以 `list_collection_tasks` 返回为运行时准据，再用 `describe_collection_task` 取单个任务的完整入参契约、示例与限制；采集能力受 entitlement 控制。