{ "openapi": "3.0.1", "info": { "title": "Zhihu 知乎 Scraper - Answers, Articles, Comments & Hot List", "description": "Scrape Zhihu (知乎) long-form Chinese Q&A: search answers, articles and pins, all answers of a question, comments and replies, the hot list, user profiles, followers and full answer text. Public author IDs and IP location where shown. No login or cookies needed. Export JSON, CSV or Excel.", "version": "0.1", "x-build-id": "7N8A60d0zdx0jGBox" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/clover_folktale~zhihu-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-clover_folktale-zhihu-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/clover_folktale~zhihu-scraper/runs": { "post": { "operationId": "runs-sync-clover_folktale-zhihu-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/clover_folktale~zhihu-scraper/run-sync": { "post": { "operationId": "run-sync-clover_folktale-zhihu-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "question", "comments", "replies", "hot", "user", "userContent", "followers", "following", "detail", "column", "trendingSearches", "suggest", "saltSearch", "relatedArticles", "homeFeed", "userIncludedArticles", "recommendedFollowees" ], "type": "string", "description": "What to scrape. Each mode reads only the fields named in its title.", "default": "search" }, "keyword": { "title": "Keyword (modes: search, suggest, saltSearch)", "type": "string", "description": "Search keyword, Chinese or English (falls back to \"python\" when empty)." }, "searchType": { "title": "Result type (mode: search)", "enum": [ "all", "answers", "articles", "users", "topics", "columns", "videoPosts", "ebooks", "papers" ], "type": "string", "description": "Answers and articles only, everything including pins, or one of the other searches: users, topics, columns, videos, ebooks or scholarly papers. Sort and time range apply only to the first three.", "default": "all" }, "sort": { "title": "Sort (mode: search)", "enum": [ "relevance", "votes", "newest" ], "type": "string", "description": "Zhihu's default ranking, most upvoted, or newest first.", "default": "relevance" }, "timeRange": { "title": "Time range (mode: search)", "enum": [ "any", "day", "week", "month", "3months", "6months", "year" ], "type": "string", "description": "Only content published within this period.", "default": "any" }, "questions": { "title": "Questions (mode: question)", "type": "array", "description": "Question links (https://www.zhihu.com/question/) or question IDs. Returns up to 200 answers per question.", "items": { "type": "string" } }, "answerOrder": { "title": "Answer order (mode: question)", "enum": [ "default", "newest" ], "type": "string", "description": "Zhihu's default order or the most recently updated first.", "default": "default" }, "includeQuestionDetail": { "title": "Include the question itself (mode: question)", "type": "boolean", "description": "Output each question itself first (description, views, followers, answer count). It is one more result per question.", "default": false }, "answers": { "title": "Answers or pins (mode: comments)", "type": "array", "description": "Answer links (https://www.zhihu.com/question//answer/) or answer IDs; a pin link (https://www.zhihu.com/pin/) reads the comments of a pin.", "items": { "type": "string" } }, "columns": { "title": "Columns (mode: column)", "type": "array", "description": "Column links (https://zhuanlan.zhihu.com/) or the ID after it.", "items": { "type": "string" } }, "articles": { "title": "Articles (mode: relatedArticles)", "type": "array", "description": "Article links (https://zhuanlan.zhihu.com/p/) or article IDs. Returns the articles Zhihu recommends next to each one.", "items": { "type": "string" } }, "commentIds": { "title": "Comment IDs (mode: replies)", "type": "array", "description": "Comment IDs (the commentId of a comment) to fetch all replies of.", "items": { "type": "string" } }, "commentSort": { "title": "Sort comments (modes: comments, replies)", "enum": [ "hot", "newest" ], "type": "string", "description": "Hottest first or newest first.", "default": "hot" }, "includeReplies": { "title": "Include replies (mode: comments)", "type": "boolean", "description": "Also output the first replies Zhihu shows under each comment (not the full reply list; use the replies mode for that). Each reply is one more result.", "default": false }, "users": { "title": "Users (modes: user, userContent, followers, following, userIncludedArticles)", "type": "array", "description": "Profile links (https://www.zhihu.com/people/) or the name after /people/.", "items": { "type": "string" } }, "userContentType": { "title": "Content type (mode: userContent)", "enum": [ "answers", "articles", "pins", "followedColumns", "followedQuestions", "followedCollections", "followedTopics" ], "type": "string", "description": "Which of the user's posts to list, or what the user follows.", "default": "answers" }, "userContentSort": { "title": "Sort (mode: userContent)", "enum": [ "newest", "votes" ], "type": "string", "description": "Newest first or most upvoted (answers and articles only; pins and followed lists have no sort).", "default": "newest" }, "links": { "title": "Links (mode: detail)", "type": "array", "description": "Answer links (https://www.zhihu.com/question//answer/), article links (https://zhuanlan.zhihu.com/p/) or pin links (https://www.zhihu.com/pin/).", "items": { "type": "string" } }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of items to return in total for this run. You are charged per item returned.", "default": 20 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }