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

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

# Search topics / 搜索话题

Search Zhihu topics by query.

按查询词搜索知乎话题。

Task / 任务: `zhihu_search_topics_v1`
Platform / 平台: Zhihu / 知乎
Billing / 计费: 2 Credits per successful task / 每个成功任务 2 Credits
Access / 调用方式: this source is available through the Search API only; call `POST /v1/search` with `source`, then read `GET /v1/search/{job_id}`. It is not listed by `list_collection_tasks` and `describe_collection_task` does not answer for it.
调用方式：该来源仅通过 Search API 提供；用 `source` 调用 `POST /v1/search`，再用 `GET /v1/search/{job_id}` 读取结果。它不出现在 `list_collection_tasks` 中，`describe_collection_task` 也不返回它。

## Limitations / 限制

- 按页翻页，使用 `page`。
- 最多 50 页。

## Inputs / 输入

- `query` — Query / 搜索词; kind=text; required=True; default=''; bounds=min_length=1, max_length=100
- `page` — Page / 页码; kind=integer; required=False; default=1; bounds=min=1, max=50

## Minimal call / 最小调用

`search`

```json
{
  "source": "zhihu_topic",
  "query": "搜索知乎上关于猫咪的话题"
}
```


## Result and pagination / 结果与分页

- 分页方式：页码翻页。`page` 传入，下一页用 `pagination.next_page` 传回（为 null 时结束）。

Search results are returned under `data.items`, with page state under `data.pagination`. /
Search 结果位于 `data.items`，分页状态位于 `data.pagination`。

Only the fields listed below are part of this source's stable Search result contract. /
只有下方列出的字段属于此来源的稳定 Search 结果契约。

## Result fields / 结果字段

- `data.items` — type=array<object>; Public Search results returned by this page. / 本页返回的公开 Search 结果。
- `data.items[].entity_id` — type=string; Stable public identifier for the result. / 结果的稳定公开标识。
- `data.items[].title` — type=string|null; Public title when supplied. / 如有则返回公开标题。
- `data.items[].url` — type=string|null; Public result URL when supplied. / 如有则返回公开结果 URL。
- `data.items[].snippet` — type=string|null; Source-independent text snippet when supplied. / 如有则返回来源无关的文本摘要。
- `data.items[].article_id` — type=string|null; Public article identifier. / 文章公开标识。
- `data.items[].summary` — type=string|null; Public summary when supplied. / 如有则返回公开摘要。
- `data.items[].description` — type=string|null; Public description when supplied. / 如有则返回公开描述。
- `data.items[].follower_count` — type=integer|null; Follower count. / 关注者数。
- `data.items[].question_count` — type=integer|null; Question count. / 问题数。
- `data.items[].visit_count` — type=integer|null; Visit count. / 访问数。
- `data.items[].top_answer_count` — type=integer|null; Top-answer count. / 优质回答数。
- `data.items[].score` — type=number|null; Public score when supplied. / 如有则返回公开评分。
- `data.pagination.has_more` — type=boolean; Whether another public Search page is available. / 是否还有下一页公开 Search 结果。
- `data.pagination.page` — type=integer|null; Current public page. / 当前公开页码。
- `data.pagination.next_page` — type=integer|null; Next public page when available. / 如有则返回下一公开页码。

This source is published by the Search API. Use `POST /v1/search` and `GET /v1/search/{job_id}`; it has no generic Collection entry point. /
该来源由 Search API 发布，请使用 `POST /v1/search` 与 `GET /v1/search/{job_id}`；它没有通用采集入口。