# Zhihu Scraper - Column Articles, Hot Searches & Suggestions (`topapi/zhihu-scraper`) Actor

Scrape Zhihu (知乎) with no login: the newest articles and answers of any Zhihu column (知乎专栏) with full text, author, votes and dates, plus hot search terms (热搜) and keyword search suggestions for Chinese keyword research. Monitor mode. $2.20 per 1,000 articles.

- **URL**: https://apify.com/topapi/zhihu-scraper.md
- **Developed by:** [Top Api](https://apify.com/topapi) (community)
- **Categories:** Social media, News, SEO tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.20 / 1,000 column articles

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Zhihu Scraper (知乎) - Column Articles, Hot Searches & Search Suggestions

Scrape Zhihu with no login, no cookie and no browser: the **newest articles and answers of any Zhihu column (知乎专栏)**
with their full text, the **hot search terms (热搜)**, and the **search suggestions** Zhihu offers for any keyword.

### What you get

| Source | Input | Rows per run | What each row has |
|---|---|---|---|
| Column articles and answers | `columnUrls` | up to the 10 newest items per column | title (the question for an answer), excerpt, full text as plain text, HTML and on request Markdown, images, upvotes, comments, published and edited dates, author (name, handle, profile link, avatar, headline, description, gender, organisation and anonymous flags), column and its total item count; answers also carry their question id and link |
| Hot searches | `includeHotSearches` | the trending terms (10 when measured) | rank, term, display text, Zhihu search link |
| Search suggestions | `suggestionQueries` | up to 10 per keyword | keyword, rank, suggested phrase, suggestion id, search tab, search link |

Every row has `record_type` (`article`, `answer`, `hot_search`, `suggestion`) and `scraped_at`.

### How to use it

```json
{
  "columnUrls": ["https://zhuanlan.zhihu.com/yiyuguancha", "https://zhuanlan.zhihu.com/xuehy"],
  "maxArticlesPerColumn": 10,
  "includeHotSearches": true,
  "suggestionQueries": ["人工智能", "考研"],
  "includeMarkdown": true,
  "maxItems": 500
}
```

- **Columns** can be given as `zhuanlan.zhihu.com/<name>`, `zhuanlan.zhihu.com/c_<id>`, `www.zhihu.com/column/<name>` or the
  bare name. A column's feed holds its articles and the answers its author added to it; `includeColumnAnswers: false`
  keeps articles only.
- **Content forms**: `includeText` (plain text in `content`, on), `includeHtml` (Zhihu's HTML in `content_html`, on),
  `includeMarkdown` (`content_markdown`, off).
- **Monitor mode** (`monitorMode: true`): each run delivers, and charges, only what earlier runs with the same sources did
  not deliver - new column items, new search terms and suggestions. A run that finds nothing new changes nothing. Schedule
  it hourly or daily; `monitorName` keeps separate memories.
- **maxItems** caps every row type together; you are never charged for more rows than that. A run's spending limit is
  honoured the same way: it stops at the limit and charges only what it delivered.
- An empty input reads a small sample: the hot searches and the 3 newest items of one column.
- Input names used by other Zhihu actors work too: `operation: "search_suggestions"` with `keyword`, `columns`,
  `startUrls` with column links.

#### Output example (an article row from a real run, text shortened)

```json
{
  "record_type": "article",
  "content_id": "2100335672779453272",
  "title": "ImageJ实用教程——基于Agent的自然语言图像处理",
  "content": "Finally，我们终于可以用自然语言来处理科研图像了。\n之前介绍过用宏和批处理减少重复操作。…",
  "content_length": 2553,
  "content_url": "https://zhuanlan.zhihu.com/p/2100335672779453272",
  "upvote_count": 41,
  "comment_count": 1,
  "publish_time": "2026-11-01T13:58:48.000Z",
  "author_name": "Treasure琛",
  "author_url_token": "zhao-yu-chen-40-11",
  "column_slug": "c_1069243926476673024"
}
```

### Field fill (measured on a 1,151-row run, 2026-11-16)

- Column articles (759): title, excerpt, full text, HTML, link, dates, upvotes, comments, author name, handle and profile link
  100%; images 86%, cover 81%, author headline 83%, author description 78% (as each author filled them).
- Column answers (57): question, full text, HTML, link, dates, upvotes, comments, author 100%; images 67%, author headline 86%.
- Hot searches (10) and suggestions (295): every field 100%, except a suggestion's `label` and `icon_url` (4%, Zhihu sets
  them on a few suggestions only).

### Limits

- Zhihu shows search results, question pages with all their answers, comments, user profiles and user post lists, and single
  answers or articles by link only to signed-in visitors. This actor does not sign in: if you ask for them the run says so in
  its status message and charges nothing for them. The hot list (知乎热榜) is not offered.
- A column shows a signed-out visitor its 10 newest items, so `maxArticlesPerColumn` goes up to 10.

### Pricing

Pay per row, no start fee:

| Row | Price |
|---|---|
| Column article | $0.0022 |
| Column answer | $0.0022 |
| Hot search term or search suggestion | $0.0009 |

Rows a monitor already delivered, and anything not delivered, are never charged.

# Actor input Schema

## `includeHotSearches` (type: `boolean`):

The terms trending in Zhihu search right now, in rank order, each with a link to its Zhihu search page.

## `suggestionQueries` (type: `array`):

For each keyword, the suggestions Zhihu's search box offers (up to 10 per keyword, in Zhihu's order) - the Chinese long-tail phrases people search for. Good for keyword research.

## `columnUrls` (type: `array`):

Column links (zhuanlan.zhihu.com/<name>, zhuanlan.zhihu.com/c_123..., www.zhihu.com/column/<name>) or bare column names. Each gives its newest items with full text: articles, and the answers its author added to the column, with author, votes, comments and dates.

## `maxArticlesPerColumn` (type: `integer`):

Newest items to take from each column (1-10): articles and, if on, answers. Zhihu shows a signed-out visitor the 10 newest items of a column.

## `includeColumnAnswers` (type: `boolean`):

A column's feed also holds answers its author added to it. On: each is delivered as an `answer` row with its question. Off: only articles.

## `maxItems` (type: `integer`):

Stop after this many rows of every type together. You are never charged for more rows than this.

## `includeText` (type: `boolean`):

Deliver each article's full text as plain text in `content`.

## `includeHtml` (type: `boolean`):

Deliver each article's full body as Zhihu's HTML in `content_html` (images, links and headings kept).

## `includeMarkdown` (type: `boolean`):

Also deliver each article's body as Markdown in `content_markdown` (for LLM and RAG pipelines).

## `monitorMode` (type: `boolean`):

Remember what earlier runs of the same input delivered and deliver (and charge) only rows that are new: questions that entered the hot list, new hot search terms and suggestions, new column articles. Schedule it to watch the hot list or a set of columns.

## `monitorName` (type: `string`):

Name of the memory a monitor keeps between runs. Runs with the same name and the same sources share it.

## `resetMonitor` (type: `boolean`):

Forget what earlier runs delivered and start the memory again from this run.

## `proxyConfiguration` (type: `object`):

Leave off: the run starts direct and moves to Apify datacenter, then residential proxies by itself when Zhihu refuses an exit. Set your own to use it first.

## Actor input object example

```json
{
  "includeHotSearches": true,
  "suggestionQueries": [],
  "columnUrls": [
    "https://zhuanlan.zhihu.com/yiyuguancha"
  ],
  "maxArticlesPerColumn": 3,
  "includeColumnAnswers": true,
  "maxItems": 100,
  "includeText": true,
  "includeHtml": true,
  "includeMarkdown": false,
  "monitorMode": false,
  "monitorName": "zhihu-scraper-monitor",
  "resetMonitor": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

One item per hot question, hot search term, search suggestion or column article (field record_type says which).

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "includeHotSearches": true,
    "suggestionQueries": [],
    "columnUrls": [
        "https://zhuanlan.zhihu.com/yiyuguancha"
    ],
    "maxArticlesPerColumn": 3
};

// Run the Actor and wait for it to finish
const run = await client.actor("topapi/zhihu-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "includeHotSearches": True,
    "suggestionQueries": [],
    "columnUrls": ["https://zhuanlan.zhihu.com/yiyuguancha"],
    "maxArticlesPerColumn": 3,
}

# Run the Actor and wait for it to finish
run = client.actor("topapi/zhihu-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "includeHotSearches": true,
  "suggestionQueries": [],
  "columnUrls": [
    "https://zhuanlan.zhihu.com/yiyuguancha"
  ],
  "maxArticlesPerColumn": 3
}' |
apify call topapi/zhihu-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,topapi/zhihu-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/techm0MG4nzD0JpyY/builds/14uAbeNbciWxIbwr1/openapi.json
