知乎(Zhihu)API:キーワード検索、回答とコメント
2026-11-21 時点の仕様に基づく
要点
知乎(Zhihu)API には 2 種類の非同期タスクがあります。POST /zhihu/search/task はキーワードと投稿日の期間(既定は直近 7 日)で知乎の回答とコラム記事を検索します。動画や「想法」などほかの種類の結果は収集しません。POST /zhihu/pushs/task は質問、回答、コラム記事の URL を受け付け、質問ならその回答を、回答や記事ならコメントとその返信を収集します。どちらも GET でポーリングし、DONE になると同じレスポンスにレコードが含まれます。各項目には URL、タイトル、本文全文、投稿者、投稿日時、賛成数とコメント数、わかる場合は投稿者の IP 所在地が含まれます。知乎のタスクは同時に実行できる数が限られ、それを超えたタスクは待ち行列に入ります。データは知乎で公開されているコンテンツをウェブクローラーで収集したものです。
機能別の API ページ
取得できるデータ
フィールドは 2026-11-21 時点の仕様に基づきます。タスクが DONE になるまでポーリングはタスクオブジェクトだけを返し、DONE になると同じレスポンスに task、total_count、data、page、pageSize が含まれます。レコードには表にないフィールドが含まれることがあり、meta_keywords、location、icon_url などの説明用フィールドは空の場合があります。
| データ | フィールド | エンドポイント |
|---|---|---|
| キーワード検索の回答とコラム記事 | id, url, title, content, tm, datetime, tm_crawler, tm_update, author, author_id, type, ctype, source, sentiment, region, like_count, comment_count, metadata_img | GET /zhihu/search/task/{task_id} |
| 検索タスクのステータスとカウンター | task: id, keyword, status, start_date, end_date, max_pages, created_at, total, completed, pages_crawled, partial, timed_out, failed_pages, failed_articles, failed_ranges | GET /zhihu/search/task/{task_id} |
| 質問の回答、または回答・記事のコメントと返信 | id, post_id, author_id, author, push_type, region, content, tm, tm_crawler, sentiment | GET /zhihu/pushs/task/{task_id} |
| 回答・コメントタスクのステータスとカウンター | 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} |
エンドポイント一覧
Base URL は https://api.infominer.io/api/v2 です。API キーは auth-header リクエストヘッダーで送信します。* の付いたパラメーターは必須です。
| メソッド | パス | 説明 | 主なパラメーター |
|---|---|---|---|
| POST | /zhihu/search/task |
回答とコラム記事のキーワード検索タスクを作成します。期間とページ上限を指定できます。 | keyword* end_date max_pages rerun start_date |
| GET | /zhihu/search/task/{task_id} |
検索タスクをポーリングします。DONE で項目と total_count を返します(1 ページ最大 100 件)。 | task_id* page pageSize |
| POST | /zhihu/pushs/task |
質問・回答・コラム記事の URL からタスクを作成します。質問なら回答、回答や記事ならコメントを収集します。 | post_url* crawl_second_layer max_pages rerun |
| GET | /zhihu/pushs/task/{task_id} |
タスクをポーリングします。DONE で回答またはコメントを返します(1 ページ最大 1000 件)。 | task_id* page pageSize |
データ取得の流れ
- POST /zhihu/search/task に keyword(1〜100 文字)と、任意の start_date・end_date(YYYY-MM-DD、UTC+8、当日を含む。既定は直近 7 日)、max_pages(0〜50。0 または省略で 20、1 ページ約 20 件)を指定します。
- GET /zhihu/search/task/{task_id} でポーリングします。タスクの準備に約 5〜10 秒、その後 1 ページ約 3〜5 秒かかります。同時実行数の上限を超えたタスクは INIT のまま待機し、待機中にタイムアウトすることはありません。3〜5 秒おきにポーリングし、全体の期限を設けてください。ステータスは INIT、RUNNING、DONE、PARTIAL、TIMED_OUT(600 秒以上進捗なし)、FAILED です。データを含むのは DONE のレスポンスだけで、それ以外はタスクオブジェクトのみを返します。DONE 前は status、DONE 後は task.status を読みます。完全に成功したのは、status が DONE で partial と timed_out がともに false の場合です。
- DONE になったら data から回答と記事を page と pageSize(1 ページ最大 100 件)で読みます。回答のタイトルはその質問のタイトルです。
- 項目についての議論が必要なときは、その URL で POST /zhihu/pushs/task を作成します。質問のタスクの data には回答(push_type は answer、1 ページ 20 件)だけが入ります。回答や記事の URL では第 1 階層のコメント(comment、1 ページ 10 件)と、crawl_second_layer(既定 true)でその返信(reply)を返します。pageSize 最大 1000 で読みます。
curl の例
キーワード検索タスクを作成
curl -X POST https://api.infominer.io/api/v2/zhihu/search/task \
-H "auth-header: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keyword": "空气炸锅", "start_date": "2026-06-01", "end_date": "2026-06-07", "max_pages": 3}'
タスク ID でポーリング
curl "https://api.infominer.io/api/v2/zhihu/search/task/$TASK_ID?page=1&pageSize=100" \
-H "auth-header: YOUR_API_KEY"
回答の URL からコメントタスクを作成
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}'
サンプル JSON
以下は手作業で作成したサンプルデータ(架空)です。アカウントは sample_user_n、ID は明らかな仮の値で、実在の投稿ではありません。
タスク作成時のレスポンス:サンプルデータ(架空)
{
"id": "00000000-0000-4000-8000-000000000001",
"keyword": "空气炸锅",
"status": "INIT",
"start_date": "2026-06-01",
"end_date": "2026-06-07",
"max_pages": 3,
"created_at": 1780880400,
"total": 0,
"completed": 0,
"pages_crawled": 0,
"timed_out": false,
"partial": false,
"failed_pages": 0,
"failed_articles": 0,
"failed_ranges": 0
}
タスク完了後のポーリングレスポンス:サンプルデータ(架空)
{
"task": {
"id": "00000000-0000-4000-8000-000000000001",
"keyword": "空气炸锅",
"status": "DONE",
"start_date": "2026-06-01",
"end_date": "2026-06-07",
"max_pages": 3,
"created_at": 1780880400,
"total": 2,
"completed": 2,
"pages_crawled": 1,
"timed_out": false,
"partial": false,
"failed_pages": 0,
"failed_articles": 0,
"failed_ranges": 0
},
"total_count": 2,
"data": [
{
"id": "00000000-0000-4000-8000-000000000001",
"url": "https://www.zhihu.com/question/100000001/answer/100000000001",
"title": "空气炸锅值得买吗?",
"content": "用了半年,说说真实感受。\n优点是做鸡翅和薯条确实方便,缺点是容量小,一家四口要分两次做。",
"tm": 1780666200,
"datetime": "2026-06-05 21:30:00",
"tm_crawler": 1780880406,
"tm_update": 1780880406,
"author": "sample_user_1",
"author_id": "0000000001",
"type": [
"sample_user_1"
],
"ctype": [
"sample_user_1"
],
"source": "zhihu",
"sentiment": "Positive",
"region": "浙江",
"like_count": 128,
"comment_count": 2,
"metadata_img": []
},
{
"id": "00000000-0000-4000-8000-000000000002",
"url": "https://zhuanlan.zhihu.com/p/100000000002",
"title": "空气炸锅选购指南:容量、功率和清洗",
"content": "这篇整理了选空气炸锅时最常被问到的三个问题。",
"tm": 1780452000,
"datetime": "2026-06-03 10:00:00",
"tm_crawler": 1780880411,
"tm_update": 1780880411,
"author": "sample_user_2",
"author_id": "0000000002",
"type": [
"sample_user_2"
],
"ctype": [
"sample_user_2"
],
"source": "zhihu",
"sentiment": "Neutral",
"region": "",
"like_count": 56,
"comment_count": 4,
"metadata_img": []
}
],
"page": 1,
"pageSize": 100
}
投稿とコメントの関連付け
回答・コメントタスクの各レコードには、所属する質問・回答・記事のドキュメント ID を示す post_id と、answer、comment、reply のいずれかの push_type があります。質問のタスクの data には回答だけが入ります。回答の下のコメントはその回答に属するため、コメントが必要なら回答の URL でタスクを作成してください。タスクのオブジェクトには zhihu_type(question、answer、article)、取得後のタイトル、知乎が表示する件数 reported_total が含まれます。data にはその項目について収集済みのすべての回答やコメント(以前のタスクの分を含む)が入るため、total_count と task.completed は一致しないことがあります。
取得期間と制限
- 検索の対象は回答とコラム記事のみです。動画、想法、関連検索などの結果は収集しません。
- 検索は網羅的ではありません。知乎の「最新」順は厳密な時系列ではなくページ間で前後するため、期間内の項目がないページが 3 回続くとタスクは終了し、深い位置にしか出てこない項目は漏れることがあります。同じ検索でも実行時刻によって件数が少し変わります。
- crawl_second_layer を指定すると、質問のタスクは各回答のコメントの 1 ページ目(最大 10 件)も収集しますが、そのコメントは回答に属し、質問のタスクの data には入りません。そのコメントや回答のすべてのコメントは、その回答の URL で作成したタスクで読みます。
- 知乎の第 1 階層コメントは設定にかかわらず 1 ページ 10 件です。
- 知乎のタスクは同時に実行できる数が限られ、超えた分は INIT で待機します。短時間に多数のリクエストを送ると知乎がしばらくアクセスを制限することもあるため、タスクは間隔を空けて作成し、失敗したタスクは時間をおいて新しい POST で再実行してください。
- data はその期間に収集済みのデータに対するキーワード一致で、以前のタスクの結果も含むため、total_count が task.completed を上回ることがあります。このタスクで収集した件数は task.completed です。いいね数・コメント数は収集時点の値です。自動では更新されないため、最新の値が必要なら新しいタスクを作成してください。検索で遡れる期間はプロジェクトの範囲に応じて確認します。
納品形式
JSON で返します。検索とコメントのタスクは DONE になるとポーリングレスポンスにレコードが含まれ、page と pageSize でページングします(検索は 1 ページ最大 100 件、コメントは最大 1000 件)。バッチファイルなどその他の納品方法はプロジェクトの範囲に応じて確認します。
トライアルの申し込み
下の申込フォームに知乎と明記し、追いたいキーワードや質問、回答とコメントの要否、想定データ量をお知らせください。範囲を確認し、トライアルと API キーの進め方についてご連絡します。
フォームにご記入のうえ、トライアルをお申し込みください。担当者が範囲を確認のうえ、トライアルと連携の進め方をご返信します。
申込フォームに記入するよくある質問
- 知乎の検索で該当する回答はすべて取得できますか?
- 必ずしも取得できません。知乎の「最新」順はページ間で前後し、期間内の項目がないページが 3 回続くとタスクが終了するため、漏れが出ることがあります。同じ検索でも実行時刻によって件数が少し変わります。
- 知乎の回答の下のコメントはどう取得しますか?
- 回答の URL(https://www.zhihu.com/question/{質問 ID}/answer/{回答 ID})で /zhihu/pushs/task を作成します。質問の URL でタスクを作成すると、data には回答だけが入ります。回答の下のコメントはその回答に属します。
- 知乎の動画や想法も検索できますか?
- いいえ。検索の対象は回答とコラム記事のみです。
- 知乎のタスクが INIT のまま進まないのはなぜですか?
- 知乎のタスクは同時に実行できる数が限られています。超えたタスクは INIT のまま待機し、先のタスクが終わると開始します。待機中に TIMED_OUT になることはありません。
- 知乎のスクレイピング API ですか?データはどのように収集していますか?
- はい。知乎で公開されているコンテンツを LargitData がウェブクローラーで収集し、API から JSON で返します。お客様側でスクレイパーを運用する必要はありません。当社は知乎と提携しておらず、知乎自身が提供する API ではありません。ご利用目的に適するかどうかは、用途と法域に応じて買い手側の法務部門でご判断ください。収集元と収集方法の説明はご提供できます。