---
title: "Keyword Search"
method: GET
path: "/api/zhihu/search/v1"
tags: ["Zhihu"]
---

# Keyword Search

`GET /api/zhihu/search/v1`

Search Zhihu by keyword with optional result-type, sort, time-interval, topic-display, and offset controls. Use it to find relevant answers, articles, or videos.

## Query parameters

- `token` string, required
- `keyword` string, required
- `offset` integer
- `showAllTopics` 'FALSE' | 'TRUE' — Zhihu search topic display switch.
- `vertical` 'answer' | 'article' | 'zvideo' — Zhihu search result type.
- `sort` 'upvoted_count' | 'created_time' — Zhihu search sorting criteria.
- `timeInterval` 'a_day' | 'a_week' | 'a_month' | 'three_months' | 'half_a_year' | 'a_year' — Zhihu search publish time interval.

## Response `200`

OK

- object
  - `code` 0 | 100 | 101 | 202 | 300 | 301 | 302 | 303 | 400 | 404 | 500 | 503 | 600 | 601 | 602, required
  - `message` string, nullable, required
  - `data` unknown, required
  - `recordTime` string, nullable, required
  - `requestId` string

## Other responses

- `400` — Invalid request parameters or body
- `401` — Invalid or inactive access token
- `403` — Permission denied
- `429` — Request rate or daily quota limit exceeded
- `500` — Internal server error
- `503` — Service temporarily unavailable

---

[API](https://skmtc.dev/justoneapi/apis/openapi-definition.md) · [All operations](https://skmtc.dev/justoneapi/apis/openapi-definition/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/justoneapi/openapi-definition/revisions/1375f3be960b/schema)