{
  "openapi": "3.0.1",
  "info": {
    "title": "Zhihu Scraper - Column Articles, Hot Searches & Suggestions",
    "description": "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.",
    "version": "0.1",
    "x-build-id": "14uAbeNbciWxIbwr1"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/topapi~zhihu-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-topapi-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/topapi~zhihu-scraper/runs": {
      "post": {
        "operationId": "runs-sync-topapi-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/topapi~zhihu-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-topapi-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",
        "properties": {
          "includeHotSearches": {
            "title": "Hot searches (热搜)",
            "type": "boolean",
            "description": "The terms trending in Zhihu search right now, in rank order, each with a link to its Zhihu search page.",
            "default": false
          },
          "suggestionQueries": {
            "title": "Search suggestions for keywords",
            "type": "array",
            "description": "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.",
            "items": {
              "type": "string"
            }
          },
          "columnUrls": {
            "title": "Zhihu columns (知乎专栏)",
            "type": "array",
            "description": "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.",
            "items": {
              "type": "string"
            }
          },
          "maxArticlesPerColumn": {
            "title": "Items per column",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "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.",
            "default": 10
          },
          "includeColumnAnswers": {
            "title": "Include answers from columns",
            "type": "boolean",
            "description": "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.",
            "default": true
          },
          "maxItems": {
            "title": "Max rows in total",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after this many rows of every type together. You are never charged for more rows than this.",
            "default": 100
          },
          "includeText": {
            "title": "Article text (plain)",
            "type": "boolean",
            "description": "Deliver each article's full text as plain text in `content`.",
            "default": true
          },
          "includeHtml": {
            "title": "Article HTML",
            "type": "boolean",
            "description": "Deliver each article's full body as Zhihu's HTML in `content_html` (images, links and headings kept).",
            "default": true
          },
          "includeMarkdown": {
            "title": "Article Markdown",
            "type": "boolean",
            "description": "Also deliver each article's body as Markdown in `content_markdown` (for LLM and RAG pipelines).",
            "default": false
          },
          "monitorMode": {
            "title": "Monitor mode: only new rows",
            "type": "boolean",
            "description": "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.",
            "default": false
          },
          "monitorName": {
            "title": "Monitor memory name",
            "type": "string",
            "description": "Name of the memory a monitor keeps between runs. Runs with the same name and the same sources share it.",
            "default": "zhihu-scraper-monitor"
          },
          "resetMonitor": {
            "title": "Reset the monitor memory",
            "type": "boolean",
            "description": "Forget what earlier runs delivered and start the memory again from this run.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "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.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}