知乎(Zhihu)回答・コメント API
2026-11-21 時点の仕様に基づく
要点
POST /zhihu/pushs/task は知乎の質問、回答、コラム記事の URL を受け付けます。質問では data に回答(push_type は answer、1 ページ 20 件)だけが入ります。回答や記事では第 1 階層のコメント(comment、1 ページ 10 件)と、crawl_second_layer(既定 true)でその返信(reply)を収集します。GET /zhihu/pushs/task/{task_id} でポーリングし、DONE になると task、total_count、data を返します(1 ページ最大 1000 件)。各レコードには post_id、投稿者、本文、日時、感情ラベル、わかる場合は IP 所在地が含まれます。データは知乎で公開されているコンテンツをウェブクローラーで収集したものです。
主な用途
- 自社の製品カテゴリーや市場に関する質問への回答をすべて集める。
- 影響力のある回答やコラム記事の下のコメントを通して読む。
- 同じ質問への回答の感情を時期ごとに比べる。
エンドポイント
Base URL は https://api.infominer.io/api/v2 です。API キーは auth-header リクエストヘッダーで送信します。
| メソッド | パス | 説明 |
|---|---|---|
| POST | /zhihu/pushs/task |
質問・回答・コラム記事の URL からタスクを作成します。質問なら回答、回答や記事ならコメントを収集します。 |
| GET | /zhihu/pushs/task/{task_id} |
タスクをポーリングします。DONE で回答またはコメントを返します(1 ページ最大 1000 件)。 |
リクエストパラメータ
POST /zhihu/pushs/task
| パラメータ | 位置 | 型 | 必須 | 既定値/指定可能な値 | 説明 |
|---|---|---|---|---|---|
post_url |
body | string | はい | 知乎の質問 URL(https://www.zhihu.com/question/{id})、回答 URL(.../question/{id}/answer/{id})、コラム記事 URL(https://zhuanlan.zhihu.com/p/{id})。クエリ文字列は除かれます。 | |
crawl_second_layer |
body | boolean | — | true |
第 2 階層:回答や記事では各コメントの返信。質問では各回答のコメントの 1 ページ目を収集しますが、回答に属するため質問のタスクの data には入りません。 |
max_pages |
body | integer | — | 20(最大 200) |
第 1 階層のページ数の上限(質問では回答、1 ページ 20 件。回答や記事では第 1 階層コメント、1 ページ 10 件)。0 または省略で既定値。 |
rerun |
body | boolean | — | ほかのプラットフォームとの互換のために受け付けます。POST するたびに新しいタスクが作成されます。 |
GET /zhihu/pushs/task/{task_id}
| パラメータ | 位置 | 型 | 必須 | 既定値/指定可能な値 | 説明 |
|---|---|---|---|---|---|
task_id |
path | string | はい | タスク作成時に返されたタスク ID。 | |
page |
query | integer | — | 1 |
ページ番号(1 から)。 |
pageSize |
query | integer | — | 1000 |
1 ページあたりの回答またはコメント数(最大 1000)。 |
レスポンスのフィールド
| データ | フィールド | エンドポイント |
|---|---|---|
| 回答、コメント、返信(data) | id, post_id, author_id, author, push_type, region, content, tm, tm_crawler, sentiment | GET /zhihu/pushs/task/{task_id} |
| タスク(task) | task: id, post_url, status, crawl_second_layer, created_at, total, completed, pages_crawled, reported_total, partial, timed_out, failed_pages, failed_batches, zhihu_type, title | GET /zhihu/pushs/task/{task_id} |
コード例
curl:タスクを作成
curl -X POST https://api.infominer.io/api/v2/zhihu/pushs/task \
-H "auth-header: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"post_url": "https://www.zhihu.com/question/100000001/answer/100000000001", "crawl_second_layer": true, "max_pages": 2}'
curl:タスク ID でポーリング
curl "https://api.infominer.io/api/v2/zhihu/pushs/task/$TASK_ID?page=1&pageSize=1000" \
-H "auth-header: YOUR_API_KEY"
Python(requests):作成・ポーリング・読み取り
import time
import requests
BASE_URL = "https://api.infominer.io/api/v2"
HEADERS = {"auth-header": "YOUR_API_KEY"}
# 1. Create the task
resp = requests.post(
f"{BASE_URL}/zhihu/pushs/task",
headers=HEADERS,
json={
"post_url": "https://www.zhihu.com/question/100000001/answer/100000000001",
"crawl_second_layer": True,
"max_pages": 2,
},
timeout=30,
)
resp.raise_for_status()
task = resp.json()
# 2. Poll until the task leaves INIT / RUNNING
for _ in range(120):
resp = requests.get(
f"{BASE_URL}/zhihu/pushs/task/{task['id']}",
headers=HEADERS,
params={
"page": 1,
"pageSize": 1000,
},
timeout=30,
)
resp.raise_for_status()
result = resp.json()
status = result.get("status") or result.get("task", {}).get("status")
if status not in ("INIT", "RUNNING"):
break
time.sleep(15)
else:
raise SystemExit("task still running; poll it again later")
task = result.get("task", result)
if status != "DONE" or task.get("partial") or task.get("timed_out"):
raise SystemExit(f"task ended with status {status}; no complete result")
# 3. Read the records (use page / pageSize to fetch further pages)
for row in result.get("data", []):
print(row.get("push_type"), row.get("author"), (row.get("content") or "")[:60])
レスポンス例
手作業で作成したサンプルデータです。アカウントは sample_user_n、ID は明らかなダミー値です。フィールドは 2026-11-21 時点の仕様に基づき、一部のフィールドのみを示しています。
タスクが DONE になった後のポーリングレスポンス(サンプルデータ)
{
"task": {
"id": "00000000-0000-4000-8000-000000000001",
"post_url": "https://www.zhihu.com/question/100000001/answer/100000000001",
"status": "DONE",
"crawl_second_layer": true,
"created_at": 1780880400,
"total": 2,
"completed": 2,
"pages_crawled": 1,
"reported_total": 2,
"timed_out": false,
"partial": false,
"failed_pages": 0,
"failed_batches": 0,
"zhihu_type": "answer",
"title": "空气炸锅值得买吗?"
},
"total_count": 2,
"data": [
{
"id": "00000000-0000-4000-8000-000000000003",
"post_id": "00000000-0000-4000-8000-000000000001",
"author_id": "0000000003",
"author": "sample_user_3",
"tm": 1780745400,
"tm_crawler": 1780880403,
"push_type": "comment",
"region": "浙江",
"content": "同感,容量确实是最大的问题",
"sentiment": "Neutral"
},
{
"id": "00000000-0000-4000-8000-000000000004",
"post_id": "00000000-0000-4000-8000-000000000001",
"author_id": "0000000004",
"author": "sample_user_4",
"tm": 1780743600,
"tm_crawler": 1780880406,
"push_type": "reply",
"region": "江苏",
"content": "可以考虑大一号的,做两人份刚好",
"sentiment": "Positive"
}
],
"page": 1,
"pageSize": 1000
}
制限と注意点
- 質問のタスクの data には回答だけが入ります。回答の下のコメントはその回答に属するため、コメントをすべて取得するには回答の URL でタスクを作成してください。
- crawl_second_layer を指定すると、質問のタスクは各回答のコメントの 1 ページ目(最大 10 件)も収集しますが、そのコメントは回答に属し、回答の URL で作成したタスクで読みます。
- 知乎の第 1 階層コメントは設定にかかわらず 1 ページ 10 件です。
- 知乎のタスクは同時に実行できる数が限られ、短時間に多数のリクエストを送ると知乎がしばらくアクセスを制限することもあります。タスクは間隔を空けて作成してください。
- データを含むのは DONE のポーリングだけで、PARTIAL、TIMED_OUT、FAILED はタスクオブジェクトのみを返します。status が DONE で partial と timed_out がともに false の場合を完全な成功として扱ってください。
- data にはその項目について収集済みのすべての回答やコメント(以前のタスクの分を含む)が入るため、total_count と task.completed は一致しないことがあります。数値は収集時点のものです。
ほかの 知乎(Zhihu) API ページ
- キーワード検索
- 回答とコメント
トライアルの申し込み
下の申込フォームに知乎と明記し、追いたいキーワードや質問、回答とコメントの要否、想定データ量をお知らせください。範囲を確認し、トライアルと API キーの進め方についてご連絡します。
フォームにご記入のうえ、トライアルをお申し込みください。担当者が範囲を確認のうえ、トライアルと連携の進め方をご返信します。
申込フォームに記入するよくある質問
- 知乎の回答の下のコメントはどう取得しますか?
- 回答の URL(https://www.zhihu.com/question/{質問 ID}/answer/{回答 ID})でタスクを作成します。質問の URL では data に回答だけが入ります。
- zhihu_type は何を表しますか?
- タスクを作成した URL の種類(question、answer、article)です。第 1 階層が回答になるかコメントになるかがこれで決まります。
- 知乎の回答タスクにはどのくらい時間がかかりますか?
- 約 5〜10 秒の準備の後、回答のコメント 2 ページで約 20 秒、質問の回答 1 ページで約 1 分です。同時実行数を超えたタスクは先に INIT で待機します。
- データはどのように収集していますか?知乎の公式 API ですか?
- 知乎で公開されているコンテンツをウェブクローラーで収集しています。当社は知乎と提携しておらず、知乎自身が提供する API ではありません。ご利用目的に適するかどうかは、用途と法域に応じて買い手側の法務部門でご判断ください。収集元と収集方法の説明はご提供できます。