Zhihu Answer List API (V1)
API health status
Healthy Available Limited Mostly unavailable No data
Loading health status...
Retrieve answers for a Zhihu question with sorting and pagination controls. Use it to browse responses to a known question and continue through additional answer pages.
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
token | query | string | Yes | - | TOKEN |
questionId | query | string | Yes | - | Question ID |
cursor | query | string | No | | Pagination cursor from previous result. |
offset | query | integer | No | 0 | Start offset, begins with 0. |
order | query | string | No | _updated | Sorting criteria for answers. Available Values: - _default: Default sorting.- _updated: Sorted by updated time. |
sessionId | query | string | No | | Session ID from previous result. |
Code Samples
bash
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/zhihu/get-answer-list/v1?token=YOUR_API_KEY&questionId=VALUE'text
I want to use the "Answer List (V1)" API from JustOneAPI.
Base URL: https://api.justoneapi.com.
API Path: /api/zhihu/get-answer-list/v1?token=YOUR_API_KEY&questionId=VALUE
API Endpoint: BASE_URL + /api/zhihu/get-answer-list/v1?token=YOUR_API_KEY&questionId=VALUE
HTTP Method: GET
Authentication: Append the "token" query parameter to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/zhihu/answer-list-v1-en.json
Parameters:
- token (query): TOKEN (Required)
- questionId (query): Question ID (Required)
- cursor (query): Pagination cursor from previous result.
- offset (query): Start offset, begins with 0.
- order (query): Sorting criteria for answers.
Available Values:
- `_default`: Default sorting.
- `_updated`: Sorted by updated time.
- sessionId (query): Session ID from previous result.
Return format: safely handle JSON or text according to the actual Content-Type.
Response Handling & Error Codes:
1. Business results should be determined by the "code" field in the response body (code 0 means success).
2. Timeout Recommendation: Set the request timeout to 120 seconds. If 120 seconds is too long for your use case, use at least 60 seconds, but a small number of requests may time out before receiving a result.
3. Business Code Reference:
- 0: Success
- 100: Invalid or Inactive Token
- 301: Collection Failed. Please Retry.
- 302: Rate Limit Exceeded
- 303: Daily Quota Exceeded
- 400: Invalid Parameters
- 500: Internal Server Error
- 600: Permission Denied
- 601: Insufficient Balance
- 602: Token Budget Exceeded
4. Code 601 means the shared account balance is insufficient. Code 602 means the current API token's own cumulative budget limit has been reached. Token budget limits do not transfer funds out of the shared account balance.
Please help me write a script in my preferred programming language to call this API and handle the response.python
import requests
BASE_URL = "https://api.justoneapi.com" # Provided by OpenAPI servers
url = BASE_URL + "/api/zhihu/get-answer-list/v1?token=YOUR_API_KEY&questionId=VALUE"
response = requests.get(url, timeout=120)
print(response.status_code)
if response.content:
content_type = response.headers.get("content-type", "").lower()
if "json" in content_type:
try:
print(response.json())
except ValueError:
print(response.text)
elif content_type.startswith("text/") or "xml" in content_type or content_type.split(";", 1)[0].strip() in {"application/javascript", "application/x-www-form-urlencoded", "application/graphql"}:
print(response.text)
else:
with open("response.bin", "wb") as output:
output.write(response.content)
print(f"Saved {len(response.content)} bytes to response.bin")js
const BASE_URL = "https://api.justoneapi.com"; // Provided by OpenAPI servers
const url = BASE_URL + "/api/zhihu/get-answer-list/v1?token=YOUR_API_KEY&questionId=VALUE";
const response = await fetch(url, {
method: "GET",
signal: AbortSignal.timeout(120000)
});
console.log(response.status);
const responseBytes = await response.arrayBuffer();
if (responseBytes.byteLength) {
const contentType = (response.headers.get("content-type") || "").toLowerCase();
const mediaType = contentType.split(";", 1)[0].trim();
const textual = contentType.startsWith("text/") || contentType.includes("json") || contentType.includes("xml") || ["application/javascript", "application/x-www-form-urlencoded", "application/graphql"].includes(mediaType);
if (textual) {
const responseText = new TextDecoder().decode(responseBytes);
let data = responseText;
if (contentType.includes("json")) {
try { data = JSON.parse(responseText); } catch { /* Keep the raw body. */ }
}
console.log(data);
} else {
console.log(`Received ${responseBytes.byteLength} binary bytes`);
}
}java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
public class Main {
public static void main(String[] args) throws Exception {
final String BASE_URL = "https://api.justoneapi.com"; // Provided by OpenAPI servers
final String url = BASE_URL + "/api/zhihu/get-answer-list/v1?token=YOUR_API_KEY&questionId=VALUE";
HttpClient client = HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(120)).build();
HttpRequest.Builder builder = HttpRequest.newBuilder()
.uri(URI.create(url))
.timeout(Duration.ofSeconds(120))
.method("GET", HttpRequest.BodyPublishers.noBody());
HttpRequest request = builder.build();
HttpResponse<byte[]> response = client.send(request, HttpResponse.BodyHandlers.ofByteArray());
System.out.println(response.statusCode());
String contentType = response.headers().firstValue("content-type").orElse("").toLowerCase();
String mediaType = contentType.split(";", 2)[0].trim();
if (contentType.startsWith("text/") || contentType.contains("json") || contentType.contains("xml") || mediaType.equals("application/javascript") || mediaType.equals("application/x-www-form-urlencoded") || mediaType.equals("application/graphql")) {
System.out.println(new String(response.body(), StandardCharsets.UTF_8));
} else {
Files.write(Path.of("response.bin"), response.body());
System.out.println("Saved " + response.body().length + " bytes to response.bin");
}
}
}go
package main
import (
"fmt"
"io"
"os"
"strings"
"net/http"
"time"
)
const BASE_URL = "https://api.justoneapi.com" // Provided by OpenAPI servers
func main() {
client := &http.Client{Timeout: 120 * time.Second}
url := BASE_URL + "/api/zhihu/get-answer-list/v1?token=YOUR_API_KEY&questionId=VALUE"
req, _ := http.NewRequest("GET", url, nil)
resp, _ := client.Do(req)
defer resp.Body.Close()
fmt.Println(resp.StatusCode)
bodyBytes, _ := io.ReadAll(resp.Body)
contentType := strings.ToLower(resp.Header.Get("Content-Type"))
mediaType := strings.TrimSpace(strings.SplitN(contentType, ";", 2)[0])
if strings.HasPrefix(contentType, "text/") || strings.Contains(contentType, "json") || strings.Contains(contentType, "xml") || mediaType == "application/javascript" || mediaType == "application/x-www-form-urlencoded" || mediaType == "application/graphql" {
fmt.Println(string(bodyBytes))
} else {
os.WriteFile("response.bin", bodyBytes, 0600)
fmt.Printf("Saved %d bytes to response.bin\n", len(bodyBytes))
}
}php
<?php
$BASE_URL = 'https://api.justoneapi.com'; // Provided by OpenAPI servers
$url = $BASE_URL . '/api/zhihu/get-answer-list/v1?token=YOUR_API_KEY&questionId=VALUE';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 120);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$contentType = strtolower((string) curl_getinfo($ch, CURLINFO_CONTENT_TYPE));
curl_close($ch);
echo $status . PHP_EOL;
$mediaType = trim(explode(';', $contentType, 2)[0]);
if (str_starts_with($contentType, 'text/') || str_contains($contentType, 'json') || str_contains($contentType, 'xml') || in_array($mediaType, ['application/javascript', 'application/x-www-form-urlencoded', 'application/graphql'], true)) {
echo $response;
} else {
file_put_contents('response.bin', $response);
echo 'Saved ' . strlen($response) . ' bytes to response.bin' . PHP_EOL;
}Response Fields
Key fields in a successful response (code = 0).
Answer list and pagination5 fields
data
Answer cards and pagination for a Zhihu question.
| Field | Type | Description |
|---|---|---|
data | array | Answer cards returned on this page. |
paging | object | Pagination details for the answer list. |
paging.page | integer | Page number reported for the current result. |
paging.is_end | boolean | Whether Zhihu marks this as the final page of answers. |
paging.next | string | Next-page URL. When is_end is false, read cursor and offset from this URL and map its session_id query parameter to sessionId. Send those values with the same questionId and order. |
Answer card3 fields
data.data[]
One answer card returned for the question.
| Field | Type | Description |
|---|---|---|
type | string | Card type reported by Zhihu. |
target_type | string | Type of content carried by the card. |
position | integer | Position reported for this answer card. |
Answer content12 fields
data.data[].target
The answer carried by this card.
| Field | Type | Description |
|---|---|---|
id | string | Zhihu identifier of the answer. |
type | string | Content type reported for the answer record. |
answer_type | string | Answer subtype reported by Zhihu. |
business_type | string | Additional answer category code reported by Zhihu. |
content | string | Answer body returned as HTML. |
excerpt | string | Plain-text excerpt of the answer. |
created_time | integer | Answer creation time as a Unix timestamp in seconds. |
updated_time | integer | Answer update time as a Unix timestamp in seconds. |
url | string | Link returned by Zhihu for this answer. |
content_need_truncated | boolean | Whether Zhihu reports that the answer content should be truncated for display. |
ip_info | string | Region label shown by Zhihu for the answer, when present. |
is_sticky | boolean | Whether Zhihu marks this answer as pinned. |
Comments and visibility status7 fields
data.data[].target
| Field | Type | Description |
|---|---|---|
is_collapsed | boolean | Whether Zhihu marks this answer as collapsed. |
collapse_reason | string | Reason text returned for collapsing the answer, when supplied. |
admin_closed_comment | boolean | Whether Zhihu reports that moderation closed comments on this answer. |
comment_permission | string | Comment permission code reported for the answer. |
can_comment | object | Comment availability reported for the answer. |
can_comment.status | boolean | Whether comments are available for this answer in the response. |
can_comment.reason | string | Reason returned for the comment availability status, if provided. |
Engagement counts9 fields
data.data[].target
| Field | Type | Description |
|---|---|---|
voteup_count | integer | Reported number of upvotes on the answer. |
comment_count | integer | Reported number of comments on the answer. |
thanks_count | integer | Reported number of thanks for the answer. |
favlists_count | integer | Reported number of favorite lists associated with the answer. |
reaction | object | Interaction information reported for the answer. |
reaction.statistics | object | Counts in Zhihu's interaction statistics. |
reaction.statistics.like_count | integer | Like count in the interaction statistics. It can differ from voteup_count. |
reaction.statistics.down_vote_count | integer | Downvote count in the interaction statistics. |
reaction.statistics.favorites | integer | Favorite count in the interaction statistics. |
Question information7 fields
data.data[].target.question
Question associated with the answer.
| Field | Type | Description |
|---|---|---|
id | string | Zhihu identifier of the question. |
title | string | Title of the question. |
type | string | Content type reported for the question record. |
question_type | string | Question subtype reported by Zhihu. |
url | string | Link returned by Zhihu for the question. |
created | integer | Question creation time as a Unix timestamp in seconds. |
updated_time | integer | Question update time as a Unix timestamp in seconds. |
Thumbnails8 fields
data.data[].target.thumbnail_info
Thumbnails returned with the answer.
| Field | Type | Description |
|---|---|---|
type | string | Thumbnail group type reported for the answer. |
count | integer | Reported number of thumbnails associated with the answer. |
thumbnails | array | Thumbnail entries provided with the answer. |
thumbnails[] | object | One answer thumbnail. |
thumbnails[].type | string | Media type reported for this thumbnail. |
thumbnails[].url | string | URL of the thumbnail. |
thumbnails[].width | integer | Width reported for the thumbnail, in pixels. |
thumbnails[].height | integer | Height reported for the thumbnail, in pixels. |
Author profile10 fields
data.data[].target.author
Public profile details of the answer author.
| Field | Type | Description |
|---|---|---|
id | string | Zhihu identifier of the answer author. |
name | string | Display name of the answer author. |
headline | string | Profile headline shown for the answer author. |
url | string | Link returned for the answer author's profile. |
avatar_url | string | Avatar URL for the answer author. |
avatar_url_template | string | Avatar URL template returned for the answer author. |
type | string | Account type reported for the answer author. |
user_type | string | Additional user-type code reported for the author. |
follower_count | integer | Reported number of followers of the answer author. |
is_org | boolean | Whether Zhihu marks the author as an organization account. |
Author badges and medals16 fields
data.data[].target.author
| Field | Type | Description |
|---|---|---|
badge | array | Badges displayed with the answer author. |
badge[] | object | One displayed author badge. |
badge[].type | string | Badge type reported by Zhihu. |
badge[].description | string | Public description displayed for the badge. |
exposed_medal | object | Medal information displayed with the author profile. |
exposed_medal.medal_id | string | Identifier of the displayed medal. |
exposed_medal.medal_name | string | Display name of the medal. |
exposed_medal.description | string | Description displayed for the medal. |
exposed_medal.avatar_url | string | Medal image URL displayed with the author's avatar. |
exposed_medal.mini_avatar_url | string | Small medal image URL, when supplied. |
exposed_medal.medal_avatar_frame | string | Avatar-frame value returned for the displayed medal. |
vip_info | object | Public membership badge information shown for the author. |
vip_info.is_vip | boolean | Whether a membership badge is active in the displayed profile details. |
vip_info.vip_icon | object | Membership icon links, when supplied. |
vip_info.vip_icon.url | string | Default membership icon URL. |
vip_info.vip_icon.night_mode_url | string | Membership icon URL for dark mode. |
Rewards and endorsements10 fields
data.data[].target
| Field | Type | Description |
|---|---|---|
reward_info | object | Reward information shown for the answer. |
reward_info.is_rewardable | boolean | Whether Zhihu reports that the answer can receive rewards. |
reward_info.reward_member_count | integer | Reported number of accounts that rewarded the answer. |
reward_info.tagline | string | Reward display text, when supplied. |
endorsements | array | Endorsements displayed with the answer, when supplied. |
endorsements[] | object | One displayed endorsement entry. |
endorsements[].elements | array | Elements displayed in the endorsement entry. |
endorsements[].elements[] | object | One displayed endorsement element. |
endorsements[].elements[].type | string | Display element type reported for the endorsement. |
endorsements[].elements[].content | string | Public text shown for this element, when provided. |
Response Example
Loading the response example...