Zhihu API

Search Zhihu content, retrieve details, comments and replies, and explore creator profiles and articles.

Use the supported content URL for a specific article or answer; a question-page URL is not an article or answer detail URL.

Platform availability

24h health
Normal
Normal

Last 30 days

Available capabilities

Each Zhihu action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.

CapabilityWhat it doesPer 1,00024-hour health
SearchsearchFind what Zhihu users write about a topic: answers, articles and videos, up to 100 per call, with upvotes, comments, favorites and author credentials.$0.56 per 1,000 requestsNormal
Content detailcontent_detailRead one Zhihu answer, article or video from its link, with title, text, upvote, comment and favorite counts, publish time and author details.$0.56 per 1,000 requestsNormal
Content commentscontent_commentsCollect top-level comments on a Zhihu answer, article or video, up to 100 per call, with text, likes, reply count, time and commenter.$0.56 per 1,000 requestsNormal
Comment repliescomment_repliesList the replies under one Zhihu comment, up to 100 per call, with text, likes, reply count, time and replier.$0.56 per 1,000 requestsNormal
DetailsprofileLook up a Zhihu author from a zhihu.com/people/ link and get bio, followers, verification label, answer and article totals and upvotes received.$0.56 per 1,000 requestsNormal
User articlesuser_articlesGather a Zhihu author's published pieces from their profile link, up to 100 per call, with type, title, full text, likes, comments, favorites and date.$0.56 per 1,000 requestsNormal

Open a capability for its parameters, response fields, code samples and trial.

What does each Zhihu action accept?

Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.

Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.

ActionRequiredOptionalDeliveryLimitPer 1,000Response fields
search

Search

Find what Zhihu users write about a topic: answers, articles and videos, up to 100 per call, with upvotes, comments, favorites and author credentials. Narrow with content_type and order with sort by overall relevance, most upvoted or newest; type tells each row's kind.

keywordcontent_type, sortSync deliveryCatalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.$0.56 per 1,000 requestsid · type · url · title · text · like_count · comment_count · collect_count · posted_at · cover_image_url · platform · author_id · author_name · author_url · author_avatar_url · author_bio · author_follower_count · author_verified · author_verification_label
content_detail

Content detail

Read one Zhihu answer, article or video from its link, with title, text, upvote, comment and favorite counts, publish time and author details. Question pages are not supported, and comments are not included.

url—Sync delivery—$0.56 per 1,000 requestsid · type · url · title · text · like_count · comment_count · collect_count · posted_at · platform · author_id · author_name · author_url · author_avatar_url · author_bio · author_follower_count · author_verified · author_verification_label
content_comments

Content comments

Collect top-level comments on a Zhihu answer, article or video, up to 100 per call, with text, likes, reply count, time and commenter. A non-zero reply_count means replies exist, which comment_replies lists; the thread is not guaranteed to be exhaustive.

url—Sync deliveryCatalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.$0.56 per 1,000 requestsid · text · like_count · posted_at · reply_count · author_id · author_name · author_avatar_url · platform
comment_replies

Comment replies

List the replies under one Zhihu comment, up to 100 per call, with text, likes, reply count, time and replier. Pass the content link plus a comment_id from a comments row whose reply count is above zero.

url, comment_id—Sync deliveryCatalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.$0.56 per 1,000 requestsid · text · like_count · posted_at · reply_count · author_id · author_name · author_avatar_url · platform
profile

Details

Look up a Zhihu author from a zhihu.com/people/ link and get bio, followers, verification label, answer and article totals and upvotes received. Content links do not work here, and the verification label does not vouch for identity.

url—Sync delivery—$0.56 per 1,000 requestsauthor_id · author_name · author_url · author_avatar_url · author_bio · author_follower_count · author_verified · author_verification_label · answer_count · article_count · received_upvote_count · platform
user_articles

User articles

Gather a Zhihu author's published pieces from their profile link, up to 100 per call, with type, title, full text, likes, comments, favorites and date. Rows share the shape of search results, and one batch may not cover the author's full archive.

url—Sync deliveryCatalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.$0.56 per 1,000 requestsid · type · url · title · text · like_count · comment_count · collect_count · posted_at · cover_image_url · platform · author_id · author_name · author_url · author_avatar_url · author_bio · author_follower_count · author_verified · author_verification_label

What do the Zhihu search parameters mean?

Find what Zhihu users write about a topic: answers, articles and videos, up to 100 per call, with upvotes, comments, favorites and author credentials. Narrow with content_type and order with sort by overall relevance, most upvoted or newest; type tells each row's kind.

Full API reference: parameters, code samples, response example and health →
keywordRequired
The content search term for the Zhihu search action. Do not pass content URLs, author handles, or profile links to this parameter.
Zhihu: Rights and Usage Rules for Answers and Articles — The Zhihu agreement distinguishes original user content like answers and articles, requiring separate author authorization for off-site republication; it also restricts automated collection and content usage. Reading content through this API does not constitute receiving platform permission or content usage rights. · Checked
content_typeOptional
Filters the content type for the search action. Allowed values are all (default), answer, article, and video. This parameter narrows matching content and does not change the response schema.
Allowed values:allanswerarticlevideo
sortOptional
Orders search results. Allowed values are general (default), upvote_count_descending for most-upvoted, and time_descending for newest publish.
Allowed values:generaltime_descendingupvote_count_descending

What do the Zhihu content_detail parameters mean?

Read one Zhihu answer, article or video from its link, with title, text, upvote, comment and favorite counts, publish time and author details. Question pages are not supported, and comments are not included.

Full API reference: parameters, code samples, response example and health →
urlRequired
The content URL or profile URL required by content-oriented actions. content_detail and content_comments accept answer, article, or video links (question pages are not supported); profile and user_articles accept zhihu.com/people/ profile links.
Zhihu: Public Articles Are Not Granted for Arbitrary Republication or Model Training — Intellectual property terms in the Zhihu agreement require verifying relevant authorizations from the author and platform, while restricting unauthorized scraping, commercial use, and AI model development or training. Reading the content does not replace these permissions, nor does it indicate an endorsement by Zhihu. · Checked

What do the Zhihu content_comments parameters mean?

Collect top-level comments on a Zhihu answer, article or video, up to 100 per call, with text, likes, reply count, time and commenter. A non-zero reply_count means replies exist, which comment_replies lists; the thread is not guaranteed to be exhaustive.

Full API reference: parameters, code samples, response example and health →
urlRequired
The content URL or profile URL required by content-oriented actions. content_detail and content_comments accept answer, article, or video links (question pages are not supported); profile and user_articles accept zhihu.com/people/ profile links.

What do the Zhihu comment_replies parameters mean?

List the replies under one Zhihu comment, up to 100 per call, with text, likes, reply count, time and replier. Pass the content link plus a comment_id from a comments row whose reply count is above zero.

Full API reference: parameters, code samples, response example and health →
urlRequired
The content URL or profile URL required by content-oriented actions. content_detail and content_comments accept answer, article, or video links (question pages are not supported); profile and user_articles accept zhihu.com/people/ profile links.
comment_idRequired
The comment identifier required by comment_replies, taken from a content_comments row whose reply_count is non-zero.

What do the Zhihu profile parameters mean?

Look up a Zhihu author from a zhihu.com/people/ link and get bio, followers, verification label, answer and article totals and upvotes received. Content links do not work here, and the verification label does not vouch for identity.

Full API reference: parameters, code samples, response example and health →
urlRequired
The content URL or profile URL required by content-oriented actions. content_detail and content_comments accept answer, article, or video links (question pages are not supported); profile and user_articles accept zhihu.com/people/ profile links.

What do the Zhihu user_articles parameters mean?

Gather a Zhihu author's published pieces from their profile link, up to 100 per call, with type, title, full text, likes, comments, favorites and date. Rows share the shape of search results, and one batch may not cover the author's full archive.

Full API reference: parameters, code samples, response example and health →
urlRequired
The content URL or profile URL required by content-oriented actions. content_detail and content_comments accept answer, article, or video links (question pages are not supported); profile and user_articles accept zhihu.com/people/ profile links.
Zhihu: Public Articles Are Not Granted for Arbitrary Republication or Model Training — Intellectual property terms in the Zhihu agreement require verifying relevant authorizations from the author and platform, while restricting unauthorized scraping, commercial use, and AI model development or training. Reading the content does not replace these permissions, nor does it indicate an endorsement by Zhihu. · Checked

How to use the Zhihu API

  1. 01Read the public catalog and choose a platform action.
  2. 02Send the platform, action, and required parameters to POST /api/v1/social.
  3. 03Handle a synchronous result, or poll the returned job ID when the action runs asynchronously.
  4. 04Store the structured response fields needed by your application.
zhihu_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"zhihu","action":"search","params":{"keyword":"<keyword>"}}'

Zhihu API questions

What can I retrieve with the Zhihu API?

Set platform to zhihu. The current catalog lists search, content detail, content comments, comment replies, details, and more. These action names identify different Zhihu objects or views; they are not interchangeable search modes.

Which input starts a Zhihu `search` request?

The content search term for the Zhihu search action. Do not pass content URLs, author handles, or profile links to this parameter. Send it as keyword inside params.

Which fields can Zhihu `search` return?

Its declared schema includes type, title, text, and like_count. A declared field can still be absent from an individual record, and every other action has its own field list.

Does every Zhihu action return immediately?

Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.