SocialDataX 知乎 Zhihu MCP

按关键词搜索知乎用户；已有用户主页链接时直接调用用户资料接口。支持 page_token 翻页。

{
  "type": "object",
  "properties": {
    "keyword": {
      "description": "用户搜索关键词或短语，例如账号名；不要传主页链接、用户 ID 或 page_token。",
      "type": "string"
    },
    "page_token": {
      "default": "",
      "description": "首页留空；后续原样传入同一关键词用户搜索返回的 next_page_token，不可跨能力使用。",
      "type": "string"
    }
  },
  "required": [
    "keyword"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "items": {
      "description": "当前页用户搜索结果。",
      "items": {
        "properties": {
          "user_id": {
            "description": "知乎用户 ID，仅用于识别用户；查询用户资料或文章列表时使用同项 profile_url，不要将此 ID 作为 profile_url。",
            "type": "string"
          },
          "name": {
            "description": "用户名称。",
            "type": "string"
          },
          "avatar_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "头像链接；不可用时为 null。"
          },
          "profile_url": {
            "description": "知乎用户主页链接；可作为 zhihu_get_user_info_by_profile_url 或 zhihu_get_user_posted_articles_by_profile_url 的 profile_url。文章列表只返回文章，不包含回答、想法或视频。",
            "type": "string"
          },
          "bio": {
            "description": "用户简介；不可用时为空字符串。",
            "type": "string"
          },
          "follower_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "粉丝数；不可用时为 null。"
          },
          "received_upvote_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "用户累计获得的赞同数；不可用时为 null。"
          },
          "answer_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "用户公开回答数；不可用时为 null。"
          },
          "article_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "用户公开文章数；不可用时为 null。"
          },
          "creation_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "平台展示的创作总数，不等同于回答数与文章数之和；不可用时为 null。"
          },
          "last_creation_time": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "最近创作时间，秒级 Unix 时间戳；不可用时为 null。"
          }
        },
        "required": [
          "user_id",
          "name",
          "avatar_url",
          "profile_url",
          "bio",
          "follower_count",
          "received_upvote_count",
          "answer_count",
          "article_count",
          "creation_count",
          "last_creation_time"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "next_page_token": {
      "description": "下一页不透明分页令牌；为空表示结束。必须原样传回同一用户搜索入口，不可跨关键词或能力使用。",
      "type": "string"
    },
    "points": {
      "type": "object",
      "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      "properties": {
        "cost": {
          "type": "integer",
          "description": "本次请求最终确认消耗的积分。",
          "minimum": 0
        },
        "balance": {
          "type": "integer",
          "description": "本次接口完成时看到的当前积分余额。",
          "minimum": 0
        }
      },
      "required": [
        "cost",
        "balance"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "items",
    "next_page_token",
    "points"
  ]
}

根据关键词获取知乎搜索输入框联想词；不用于搜索用户或内容。

{
  "type": "object",
  "properties": {
    "keyword": {
      "description": "搜索关键词或短语；不要传链接、用户 ID 或 page_token。",
      "type": "string"
    }
  },
  "required": [
    "keyword"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "items": {
      "description": "搜索建议列表。",
      "items": {
        "properties": {
          "text": {
            "description": "搜索输入框联想词。",
            "type": "string"
          },
          "label": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "平台返回的建议标记，例如 hot、pu_user；不作为完整分类枚举，无标记时为 null。"
          },
          "icon_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "建议展示图标链接；无图标或不可用时为 null。"
          }
        },
        "required": [
          "text",
          "label",
          "icon_url"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "points": {
      "type": "object",
      "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      "properties": {
        "cost": {
          "type": "integer",
          "description": "本次请求最终确认消耗的积分。",
          "minimum": 0
        },
        "balance": {
          "type": "integer",
          "description": "本次接口完成时看到的当前积分余额。",
          "minimum": 0
        }
      },
      "required": [
        "cost",
        "balance"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "items",
    "points"
  ]
}

读取知乎热榜，返回当前热榜问题标题、热度、回答数和问题链接。

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "items": {
      "description": "当前知乎热榜列表；当前不支持翻页。",
      "items": {
        "properties": {
          "rank": {
            "description": "热榜排名，从 1 开始。",
            "type": "integer"
          },
          "question_id": {
            "description": "知乎问题 ID；用于识别热榜问题，不是详情或评论输入。",
            "type": "string"
          },
          "title": {
            "description": "热榜问题标题。",
            "type": "string"
          },
          "summary": {
            "description": "热榜问题摘要；不可用时为空字符串。",
            "type": "string"
          },
          "question_url": {
            "description": "可打开的知乎问题页面链接；不是详情或评论请求的 content_url。",
            "type": "string"
          },
          "cover_image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "热榜封面图链接；不可用时为 null。"
          },
          "hot_value": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "热度值；不可用时为 null。"
          },
          "answer_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "该问题回答数；不可用时为 null。"
          }
        },
        "required": [
          "rank",
          "question_id",
          "title",
          "summary",
          "question_url",
          "cover_image_url",
          "hot_value",
          "answer_count"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "points": {
      "type": "object",
      "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      "properties": {
        "cost": {
          "type": "integer",
          "description": "本次请求最终确认消耗的积分。",
          "minimum": 0
        },
        "balance": {
          "type": "integer",
          "description": "本次接口完成时看到的当前积分余额。",
          "minimum": 0
        }
      },
      "required": [
        "cost",
        "balance"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "items",
    "points"
  ]
}

按搜索词搜索知乎公开内容。用户需要按搜索词查找内容时使用；已有回答页、专栏文章页或独立视频页链接且需要详情或评论时使用对应 URL 工具；已有用户主页链接时使用用户资料或文章列表工具；支持类型、排序、发布时间筛选与 page_token 翻页。

{
  "type": "object",
  "properties": {
    "keyword": {
      "description": "知乎内容搜索词，可传关键词或短语，例如问题、话题、人物、机构或内容需求；不要传问题链接、回答链接、专栏文章链接、视频链接、用户主页链接或 page_token。",
      "type": "string"
    },
    "page_token": {
      "default": "",
      "description": "知乎搜索分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一关键词、同一类型筛选、同一排序和同一发布时间筛选链路。更换关键词、类型、排序或发布时间筛选时，请清空 page_token 后从第一页重新搜索。",
      "type": "string"
    },
    "content_type": {
      "default": "all",
      "description": "内容类型筛选：all=不限类型，answer=只看回答，article=只看文章，video=只看视频内容（可能返回独立视频 video 或带视频的回答 videoanswer；videoanswer 不是独立视频，也不是筛选取值）。",
      "enum": [
        "all",
        "answer",
        "article",
        "video"
      ],
      "type": "string"
    },
    "sort_type": {
      "default": "general",
      "description": "排序方式：general=综合排序，upvote_count_descending=最多赞同，time_descending=最新发布。如无明确排序需求，保持 general。",
      "enum": [
        "general",
        "upvote_count_descending",
        "time_descending"
      ],
      "type": "string"
    },
    "publish_time_range": {
      "default": "all",
      "description": "发布时间筛选：all=不限时间，day=一天内，week=一周内，month=一月内，three_months=三月内，half_year=半年内，year=一年内。如无明确筛选需求，保持 all。",
      "enum": [
        "all",
        "day",
        "week",
        "month",
        "three_months",
        "half_year",
        "year"
      ],
      "type": "string"
    }
  },
  "required": [
    "keyword"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "items": {
      "description": "当前页知乎内容列表；当前页可能为空，是否可继续翻页以 next_page_token 是否为空为准。",
      "items": {
        "properties": {
          "content_id": {
            "description": "知乎内容 ID；结合 content_type 可作为搜索结果去重和引用的稳定键；videoanswer 的 content_id 是回答 ID。不要把 content_id 当作详情或评论输入；读取详情、评论、打开或展示内容时优先使用非空的 content_url。",
            "type": "string"
          },
          "content_type": {
            "description": "内容类型；当前可能为 answer、article、video 或 videoanswer。videoanswer 表示带视频的回答，不是独立视频；它的 content_id 是回答 ID，content_url 是回答页链接，传 content_url 读取详情时返回 answer。",
            "enum": [
              "answer",
              "article",
              "video",
              "videoanswer"
            ],
            "type": "string"
          },
          "title": {
            "description": "内容标题；answer 和 videoanswer 结果通常为所属问题标题；不可用时为空字符串。",
            "type": "string"
          },
          "summary": {
            "description": "搜索结果摘要；不是全文；不可用时为空字符串。",
            "type": "string"
          },
          "content_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "内容页面链接；非空时可作为内容详情或评论请求的 content_url；需要打开或引用内容时优先使用；不可用时为 null。"
          },
          "cover_image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "封面图链接；不可用时为 null。"
          },
          "image_urls": {
            "description": "搜索结果携带的内容图片链接列表；不保证覆盖详情页完整图片；无图片时为空数组。",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "author": {
            "properties": {
              "user_id": {
                "description": "知乎作者用户 ID；用于识别作者，不是内容详情、博主资料或作者文章列表输入；不可用时为空字符串。",
                "type": "string"
              },
              "name": {
                "description": "知乎作者名称；不可用时为空字符串。",
                "type": "string"
              },
              "avatar_url": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "作者头像链接；不可用时为 null。"
              },
              "profile_url": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "作者主页链接；可作为 zhihu_get_user_info_by_profile_url 或 zhihu_get_user_posted_articles_by_profile_url 的 profile_url；不是内容详情或评论请求的 content_url；不可用时为 null。"
              },
              "bio": {
                "description": "作者简介；不可用时为空字符串。",
                "type": "string"
              },
              "verification_label": {
                "description": "作者认证文案；不可用时为空字符串。",
                "type": "string"
              },
              "verified": {
                "description": "作者是否为认证账号。",
                "type": "boolean"
              },
              "follower_count": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "作者粉丝数；不可用时为 null。"
              },
              "received_upvote_count": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "作者累计获得的赞同数；不可用时为 null。"
              }
            },
            "required": [
              "user_id",
              "name",
              "avatar_url",
              "profile_url",
              "bio",
              "verification_label",
              "verified",
              "follower_count",
              "received_upvote_count"
            ],
            "type": "object",
            "description": "作者信息。"
          },
          "answer": {
            "anyOf": [
              {
                "properties": {
                  "visit_count": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "回答访问数；不是文章阅读数或视频播放数；不可用时为 null。"
                  }
                },
                "required": [
                  "visit_count"
                ],
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "description": "回答类指标，不是回答正文；answer 和 videoanswer 结果返回对象，其他结果为 null。"
          },
          "question": {
            "anyOf": [
              {
                "properties": {
                  "question_id": {
                    "description": "知乎问题 ID；用于按问题聚合回答，不是内容详情或评论输入；不可用时为空字符串。",
                    "type": "string"
                  },
                  "title": {
                    "description": "问题标题；不可用时为空字符串。",
                    "type": "string"
                  },
                  "question_url": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "知乎问题页面链接；不是内容详情或评论请求的 content_url；不可用时为 null。"
                  }
                },
                "required": [
                  "question_id",
                  "title",
                  "question_url"
                ],
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "description": "回答所属问题摘要；answer 和 videoanswer 结果返回对象，其他结果为 null。"
          },
          "video": {
            "anyOf": [
              {
                "properties": {
                  "duration_ms": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "视频时长，毫秒；不可用时为 null。"
                  },
                  "play_count": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "视频播放数；不可用时为 null。"
                  }
                },
                "required": [
                  "duration_ms",
                  "play_count"
                ],
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "description": "搜索结果携带的视频摘要指标；不包含播放资源 play_url；需要视频播放资源时，用非空的 content_url 调用详情工具；video 和 videoanswer 结果可能返回对象，无视频信息时为 null。"
          },
          "upvote_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "赞同数；不可用时为 null。"
          },
          "comment_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "评论数；不可用时为 null。"
          },
          "collect_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "收藏数；不可用时为 null。"
          },
          "publish_time": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "发布时间，秒级 Unix 时间戳；不可用时为 null。"
          },
          "update_time": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "更新时间，秒级 Unix 时间戳；不可用时为 null。"
          }
        },
        "required": [
          "content_id",
          "content_type",
          "title",
          "summary",
          "content_url",
          "cover_image_url",
          "image_urls",
          "author",
          "answer",
          "question",
          "video",
          "upvote_count",
          "comment_count",
          "collect_count",
          "publish_time",
          "update_time"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "next_page_token": {
      "description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；只用于当前搜索续页；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。",
      "type": "string"
    },
    "points": {
      "type": "object",
      "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      "properties": {
        "cost": {
          "type": "integer",
          "description": "本次请求最终确认消耗的积分。",
          "minimum": 0
        },
        "balance": {
          "type": "integer",
          "description": "本次接口完成时看到的当前积分余额。",
          "minimum": 0
        }
      },
      "required": [
        "cost",
        "balance"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "items",
    "next_page_token",
    "points"
  ]
}

根据知乎回答页（包括带视频的回答）、专栏文章页或独立视频页链接读取详情。

{
  "type": "object",
  "properties": {
    "content_url": {
      "description": "知乎内容页面链接；只传下面三类已支持的知乎网页链接格式，不要传接口地址、短链接、移动端链接或包含链接的分享文案；从搜索结果读取详情时，直接传搜索结果里非空的 content_url；不要只传 content_id 或数字 ID，不要自行拼接链接；不要传问题页链接或作者主页链接；支持回答页链接（包括带视频的回答） https://www.zhihu.com/question/{question_id}/answer/{answer_id}、专栏文章链接 https://zhuanlan.zhihu.com/p/{article_id}、独立视频链接 https://www.zhihu.com/zvideo/{zvideo_id}。",
      "type": "string"
    }
  },
  "required": [
    "content_url"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "content_id": {
      "description": "知乎内容 ID；用于识别内容；不要把 content_id 当作详情或评论输入。",
      "type": "string"
    },
    "content_type": {
      "description": "内容类型：answer=回答（包括带视频的回答详情），article=文章，video=独立视频；详情不会返回 videoanswer。",
      "enum": [
        "answer",
        "article",
        "video"
      ],
      "type": "string"
    },
    "title": {
      "description": "内容标题；answer 通常为所属问题标题。",
      "type": "string"
    },
    "content": {
      "description": "详情正文或视频描述纯文本；视频详情不是视频转写；不可用时为空字符串。",
      "type": "string"
    },
    "content_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "可打开的知乎内容页面链接；可作为评论请求的 content_url；不可用时为 null；不要自行拼接。"
    },
    "cover_image_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "封面图链接；不可用时为 null。"
    },
    "image_urls": {
      "description": "回答或文章详情正文中解析到的图片链接列表；视频详情返回空数组；无图片时为空数组。",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "images": {
      "description": "正文图片列表，包含链接及宽高；无图时为空数组。",
      "items": {
        "properties": {
          "url": {
            "description": "图片链接。",
            "type": "string"
          },
          "width": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "图片宽度，像素；不可用时为 null。"
          },
          "height": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "图片高度，像素；不可用时为 null。"
          }
        },
        "required": [
          "url",
          "width",
          "height"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "author": {
      "properties": {
        "user_id": {
          "description": "知乎作者用户 ID；用于识别作者，不是内容详情、博主资料或作者文章列表输入；不可用时为空字符串。",
          "type": "string"
        },
        "name": {
          "description": "知乎作者名称；不可用时为空字符串。",
          "type": "string"
        },
        "avatar_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "作者头像链接；不可用时为 null。"
        },
        "profile_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "作者主页链接；可作为 zhihu_get_user_info_by_profile_url 或 zhihu_get_user_posted_articles_by_profile_url 的 profile_url；不是内容详情或评论请求的 content_url；不可用时为 null。"
        },
        "bio": {
          "description": "作者简介；不可用时为空字符串。",
          "type": "string"
        },
        "verification_label": {
          "description": "作者认证文案；不可用时为空字符串。",
          "type": "string"
        },
        "verified": {
          "description": "作者是否为认证账号。",
          "type": "boolean"
        },
        "follower_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "description": "作者粉丝数；不可用时为 null。"
        },
        "received_upvote_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "description": "作者累计获得的赞同数；不可用时为 null。"
        }
      },
      "required": [
        "user_id",
        "name",
        "avatar_url",
        "profile_url",
        "bio",
        "verification_label",
        "verified",
        "follower_count",
        "received_upvote_count"
      ],
      "type": "object",
      "description": "作者信息。"
    },
    "question": {
      "anyOf": [
        {
          "properties": {
            "question_id": {
              "description": "知乎问题 ID；用于按问题聚合回答，不是内容详情或评论输入；不可用时为空字符串。",
              "type": "string"
            },
            "title": {
              "description": "问题标题；不可用时为空字符串。",
              "type": "string"
            },
            "question_url": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "知乎问题页面链接；不是内容详情或评论请求的 content_url；不可用时为 null。"
            }
          },
          "required": [
            "question_id",
            "title",
            "question_url"
          ],
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "description": "回答所属问题摘要；answer（包括带视频的回答详情）返回对象，article 和独立视频 video 为 null。"
    },
    "video": {
      "anyOf": [
        {
          "properties": {
            "play_url": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "视频播放资源链接；优先返回高清 MP4 资源；可能随时间失效，不是内容页面 content_url；不可用时为 null。"
            },
            "duration_ms": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "description": "视频时长，毫秒；不可用时为 null。"
            },
            "play_count": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "description": "视频播放数；不可用时为 null。"
            },
            "width": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "description": "视频宽度，像素；不可用时为 null。"
            },
            "height": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "description": "视频高度，像素；不可用时为 null。"
            }
          },
          "required": [
            "play_url",
            "duration_ms",
            "play_count",
            "width",
            "height"
          ],
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "description": "视频信息；独立视频详情和带视频的回答详情可能返回对象；包含可用时的播放资源 play_url；普通回答、文章或无视频信息时为 null。"
    },
    "upvote_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "赞同数；不可用时为 null。"
    },
    "comment_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "评论数；不可用时为 null。"
    },
    "collect_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "收藏数；不可用时为 null。"
    },
    "like_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "喜欢数；与赞同数 upvote_count 不同；不可用时为 null。"
    },
    "share_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "分享数；不可用时为 null。"
    },
    "ip_location": {
      "description": "IP 属地；不可用时为空字符串。",
      "type": "string"
    },
    "topic_tags": {
      "description": "知乎话题标签列表；无标签时为空数组；每项只返回 name。",
      "items": {
        "additionalProperties": false,
        "properties": {
          "name": {
            "description": "话题标签名称。",
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "publish_time": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "发布时间，秒级 Unix 时间戳；不可用时为 null。"
    },
    "update_time": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "更新时间，秒级 Unix 时间戳；不可用时为 null。"
    },
    "points": {
      "type": "object",
      "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      "properties": {
        "cost": {
          "type": "integer",
          "description": "本次请求最终确认消耗的积分。",
          "minimum": 0
        },
        "balance": {
          "type": "integer",
          "description": "本次接口完成时看到的当前积分余额。",
          "minimum": 0
        }
      },
      "required": [
        "cost",
        "balance"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "content_id",
    "content_type",
    "title",
    "content",
    "content_url",
    "cover_image_url",
    "image_urls",
    "images",
    "author",
    "question",
    "video",
    "upvote_count",
    "comment_count",
    "collect_count",
    "like_count",
    "share_count",
    "ip_location",
    "topic_tags",
    "publish_time",
    "update_time",
    "points"
  ]
}

根据知乎用户主页链接读取公开博主资料。

{
  "type": "object",
  "properties": {
    "profile_url": {
      "description": "知乎用户主页链接；只传 https://www.zhihu.com/people/{url_token} 这种主页链接；不要传 user_id、昵称、回答链接、专栏文章链接、问题页链接、接口地址、短链接、移动端链接或包含链接的分享文案；从用户搜索结果继续时，直接复用所选用户的 items[].profile_url；从内容搜索、详情、评论或评论回复结果继续时，复用所选作者的 author.profile_url。",
      "type": "string"
    }
  },
  "required": [
    "profile_url"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "user_id": {
      "description": "知乎用户 ID；用于识别博主，不是当前知乎博主资料或作者文章列表输入；不可用时为空字符串。",
      "type": "string"
    },
    "name": {
      "description": "知乎用户名称；不可用时为空字符串。",
      "type": "string"
    },
    "avatar_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "用户头像链接；不可用时为 null。"
    },
    "profile_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "知乎用户主页链接；可直接复用为 zhihu_get_user_info_by_profile_url 或 zhihu_get_user_posted_articles_by_profile_url 的 profile_url；不可用时为 null。"
    },
    "bio": {
      "description": "知乎用户简介；不可用时为空字符串。",
      "type": "string"
    },
    "gender": {
      "description": "知乎用户性别：male=男，female=女，unknown=未知。",
      "enum": [
        "male",
        "female",
        "unknown"
      ],
      "type": "string"
    },
    "verification_label": {
      "description": "知乎用户认证文案；不可用时为空字符串。",
      "type": "string"
    },
    "verified": {
      "description": "知乎用户是否为认证账号。",
      "type": "boolean"
    },
    "follower_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "知乎用户粉丝数；不可用时为 null。"
    },
    "answer_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "知乎用户公开回答数；不可用时为 null。"
    },
    "article_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "知乎用户公开文章数；不可用时为 null。"
    },
    "ip_location": {
      "description": "知乎用户 IP 属地；不可用时为空字符串。",
      "type": "string"
    },
    "points": {
      "type": "object",
      "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      "properties": {
        "cost": {
          "type": "integer",
          "description": "本次请求最终确认消耗的积分。",
          "minimum": 0
        },
        "balance": {
          "type": "integer",
          "description": "本次接口完成时看到的当前积分余额。",
          "minimum": 0
        }
      },
      "required": [
        "cost",
        "balance"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "user_id",
    "name",
    "avatar_url",
    "profile_url",
    "bio",
    "gender",
    "verification_label",
    "verified",
    "follower_count",
    "answer_count",
    "article_count",
    "ip_location",
    "points"
  ]
}

根据知乎用户主页链接读取该用户发布的文章列表。只返回文章，不返回回答、想法或视频；支持使用 page_token 继续翻页。

{
  "type": "object",
  "properties": {
    "profile_url": {
      "description": "知乎用户主页链接；只传 https://www.zhihu.com/people/{url_token} 这种主页链接；不要传 user_id、昵称、回答链接、专栏文章链接、问题页链接、接口地址、短链接、移动端链接或包含链接的分享文案；从用户搜索结果继续时，直接复用所选用户的 items[].profile_url；从内容搜索、详情、评论或评论回复结果继续时，复用所选作者的 author.profile_url；从博主信息结果继续时，复用返回的 profile_url。",
      "type": "string"
    },
    "page_token": {
      "default": "",
      "description": "知乎用户发布文章列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一 profile_url 的文章列表链路；更换作者时，请清空 page_token 后从第一页重新读取。",
      "type": "string"
    }
  },
  "required": [
    "profile_url"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "items": {
      "description": "当前页知乎用户发布文章列表；当前页可能为空，是否可继续翻页以 next_page_token 是否为空为准。",
      "items": {
        "properties": {
          "content_id": {
            "description": "知乎内容 ID；用于识别用户发布文章列表项；不要把 content_id 当作详情、评论或博主资料输入。",
            "type": "string"
          },
          "title": {
            "description": "文章标题；不可用时为空字符串。",
            "type": "string"
          },
          "summary": {
            "description": "文章列表摘要；不是详情全文；不可用时为空字符串。",
            "type": "string"
          },
          "content_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "可打开的知乎文章页面链接；非空时可作为详情或评论请求的 content_url；不可用时为 null。"
          },
          "cover_image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "封面图链接；不可用时为 null。"
          },
          "author": {
            "properties": {
              "user_id": {
                "description": "知乎作者用户 ID；用于识别作者，不是内容详情、博主资料或作者文章列表输入；不可用时为空字符串。",
                "type": "string"
              },
              "name": {
                "description": "知乎作者名称；不可用时为空字符串。",
                "type": "string"
              },
              "avatar_url": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "作者头像链接；不可用时为 null。"
              },
              "profile_url": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "作者主页链接；可作为 zhihu_get_user_info_by_profile_url 或 zhihu_get_user_posted_articles_by_profile_url 的 profile_url；不是内容详情或评论请求的 content_url；不可用时为 null。"
              },
              "bio": {
                "description": "作者简介；不可用时为空字符串。",
                "type": "string"
              },
              "verification_label": {
                "description": "作者认证文案；不可用时为空字符串。",
                "type": "string"
              },
              "verified": {
                "description": "作者是否为认证账号。",
                "type": "boolean"
              },
              "follower_count": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "作者粉丝数；不可用时为 null。"
              },
              "received_upvote_count": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "作者累计获得的赞同数；不可用时为 null。"
              }
            },
            "required": [
              "user_id",
              "name",
              "avatar_url",
              "profile_url",
              "bio",
              "verification_label",
              "verified",
              "follower_count",
              "received_upvote_count"
            ],
            "type": "object",
            "description": "作者信息。"
          },
          "upvote_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "赞同数；不可用时为 null。"
          },
          "like_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "喜欢数；与赞同数 upvote_count 不同；不可用时为 null。"
          },
          "comment_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "评论数；不可用时为 null。"
          },
          "collect_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "收藏数；不可用时为 null。"
          },
          "publish_time": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "发布时间，秒级 Unix 时间戳；不可用时为 null。"
          },
          "update_time": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "更新时间，秒级 Unix 时间戳；不可用时为 null。"
          }
        },
        "required": [
          "content_id",
          "title",
          "summary",
          "content_url",
          "cover_image_url",
          "author",
          "upvote_count",
          "like_count",
          "comment_count",
          "collect_count",
          "publish_time",
          "update_time"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "next_page_token": {
      "description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；只用于当前用户发布文章列表续页；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。",
      "type": "string"
    },
    "points": {
      "type": "object",
      "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      "properties": {
        "cost": {
          "type": "integer",
          "description": "本次请求最终确认消耗的积分。",
          "minimum": 0
        },
        "balance": {
          "type": "integer",
          "description": "本次接口完成时看到的当前积分余额。",
          "minimum": 0
        }
      },
      "required": [
        "cost",
        "balance"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "items",
    "next_page_token",
    "points"
  ]
}

根据知乎回答页（包括带视频的回答）、专栏文章页或独立视频页链接读取一级评论。支持使用 sort_type 选择排序，并使用 page_token 继续翻页。

{
  "type": "object",
  "properties": {
    "content_url": {
      "description": "知乎内容页面链接；只传回答页链接（包括带视频的回答）、专栏文章链接或独立视频链接；从搜索结果中的 answer、article、video 或 videoanswer 读取评论时，直接传该结果里非空的 content_url；不要只传 content_id 或数字 ID，不要传接口地址、短链接、移动端链接、包含链接的分享文案、问题页链接或作者主页链接；支持回答页链接 https://www.zhihu.com/question/{question_id}/answer/{answer_id}、专栏文章链接 https://zhuanlan.zhihu.com/p/{article_id}、独立视频链接 https://www.zhihu.com/zvideo/{zvideo_id}。",
      "type": "string"
    },
    "page_token": {
      "default": "",
      "description": "知乎评论分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一 content_url 和同一排序链路；更换链接或排序时，请清空 page_token 后从第一页重新读取评论。",
      "type": "string"
    },
    "sort_type": {
      "default": "default",
      "description": "评论排序方式：default=默认，time_descending=最新。如无明确排序需求，保持 default。",
      "enum": [
        "default",
        "time_descending"
      ],
      "type": "string"
    }
  },
  "required": [
    "content_url"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "items": {
      "description": "当前页一级评论列表；当前页可能为空数组；是否可继续翻页以 next_page_token 是否为空为准。",
      "items": {
        "properties": {
          "comment_id": {
            "description": "知乎一级评论 ID；可作为 zhihu_get_comment_replies_by_url 的 comment_id。",
            "type": "string"
          },
          "content": {
            "description": "评论正文纯文本；不可用时为空字符串。",
            "type": "string"
          },
          "publish_time": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "评论发布时间，秒级 Unix 时间戳；不可用时为 null。"
          },
          "like_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "评论点赞数；不可用时为 null。"
          },
          "reply_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "一级评论下的回复数；不可用时为 null。"
          },
          "is_pinned": {
            "description": "评论是否置顶。",
            "type": "boolean"
          },
          "is_author_comment": {
            "description": "是否为内容作者本人发布的评论。",
            "type": "boolean"
          },
          "ip_location": {
            "description": "评论发布时的 IP 属地；不可用时为空字符串。",
            "type": "string"
          },
          "author": {
            "properties": {
              "user_id": {
                "description": "知乎作者用户 ID；用于识别作者，不是内容详情、博主资料或作者文章列表输入；不可用时为空字符串。",
                "type": "string"
              },
              "name": {
                "description": "知乎作者名称；不可用时为空字符串。",
                "type": "string"
              },
              "avatar_url": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "作者头像链接；不可用时为 null。"
              },
              "profile_url": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "作者主页链接；可作为 zhihu_get_user_info_by_profile_url 或 zhihu_get_user_posted_articles_by_profile_url 的 profile_url；不是内容详情或评论请求的 content_url；不可用时为 null。"
              },
              "bio": {
                "description": "作者简介；不可用时为空字符串。",
                "type": "string"
              },
              "verification_label": {
                "description": "作者认证文案；不可用时为空字符串。",
                "type": "string"
              },
              "verified": {
                "description": "作者是否为认证账号。",
                "type": "boolean"
              },
              "follower_count": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "作者粉丝数；不可用时为 null。"
              },
              "received_upvote_count": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "作者累计获得的赞同数；不可用时为 null。"
              }
            },
            "required": [
              "user_id",
              "name",
              "avatar_url",
              "profile_url",
              "bio",
              "verification_label",
              "verified",
              "follower_count",
              "received_upvote_count"
            ],
            "type": "object",
            "description": "评论作者信息。"
          }
        },
        "required": [
          "comment_id",
          "content",
          "publish_time",
          "like_count",
          "reply_count",
          "is_pinned",
          "is_author_comment",
          "ip_location",
          "author"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "next_page_token": {
      "description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；只用于当前评论续页；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。",
      "type": "string"
    },
    "comment_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "该评论区评论数；不是当前页 items 数量；独立视频场景下也不一定等于一级评论总数；不可用时为 null。"
    },
    "points": {
      "type": "object",
      "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      "properties": {
        "cost": {
          "type": "integer",
          "description": "本次请求最终确认消耗的积分。",
          "minimum": 0
        },
        "balance": {
          "type": "integer",
          "description": "本次接口完成时看到的当前积分余额。",
          "minimum": 0
        }
      },
      "required": [
        "cost",
        "balance"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "items",
    "next_page_token",
    "comment_count",
    "points"
  ]
}

根据知乎内容页链接和一级评论 ID 读取评论回复。用户已提供完整合法的 content_url 和一级评论 comment_id 时直接使用；已有 content_url 但缺少一级评论 comment_id 时，调用 zhihu_get_content_comments_by_url，复用同一 content_url，并使用一级评论的 items[*].comment_id；缺少内容定位信息时向用户索取；支持使用 page_token 继续翻页。

{
  "type": "object",
  "properties": {
    "content_url": {
      "description": "知乎内容页面链接；用户已提供时直接使用，否则请直接复用读取该一级评论时使用的回答页链接（包括带视频的回答）、专栏文章链接或独立视频链接；通常直接复用 zhihu_get_content_comments_by_url 使用的 content_url；不要只传 content_id 或数字 ID，不要传接口地址、短链接、移动端链接、包含链接的分享文案、问题页链接或作者主页链接；支持回答页链接 https://www.zhihu.com/question/{question_id}/answer/{answer_id}、专栏文章链接 https://zhuanlan.zhihu.com/p/{article_id}、独立视频链接 https://www.zhihu.com/zvideo/{zvideo_id}。",
      "type": "string"
    },
    "comment_id": {
      "description": "一级评论 ID；用户已提供时直接使用，否则请直接复制 zhihu_get_content_comments_by_url 返回的 items[*].comment_id；不要传评论回复项自身的 comment_id。",
      "type": "string"
    },
    "page_token": {
      "default": "",
      "description": "知乎评论回复分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一 content_url 和同一 comment_id 链路；更换链接或一级评论 comment_id 时，请清空 page_token 后从第一页重新读取回复。",
      "type": "string"
    }
  },
  "required": [
    "content_url",
    "comment_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "items": {
      "description": "当前页评论回复列表；当前页可能为空数组；是否可继续翻页以 next_page_token 是否为空为准。",
      "items": {
        "properties": {
          "comment_id": {
            "description": "当前评论回复自身的评论 ID；不是输入里的一级评论 comment_id。",
            "type": "string"
          },
          "parent_comment_id": {
            "description": "所属一级评论 ID；等于本次读取回复时传入的一级评论 comment_id。",
            "type": "string"
          },
          "reply_to_comment_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "被回复的二级评论 ID；直接回复一级评论时为 null。"
          },
          "content": {
            "description": "评论回复正文纯文本；不可用时为空字符串。",
            "type": "string"
          },
          "publish_time": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "评论回复发布时间，秒级 Unix 时间戳；不可用时为 null。"
          },
          "like_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "评论回复点赞数；不可用时为 null。"
          },
          "is_author_comment": {
            "description": "是否为内容作者本人发布的评论回复。",
            "type": "boolean"
          },
          "ip_location": {
            "description": "评论回复发布时的 IP 属地；不可用时为空字符串。",
            "type": "string"
          },
          "author": {
            "properties": {
              "user_id": {
                "description": "知乎作者用户 ID；用于识别作者，不是内容详情、博主资料或作者文章列表输入；不可用时为空字符串。",
                "type": "string"
              },
              "name": {
                "description": "知乎作者名称；不可用时为空字符串。",
                "type": "string"
              },
              "avatar_url": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "作者头像链接；不可用时为 null。"
              },
              "profile_url": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "作者主页链接；可作为 zhihu_get_user_info_by_profile_url 或 zhihu_get_user_posted_articles_by_profile_url 的 profile_url；不是内容详情或评论请求的 content_url；不可用时为 null。"
              },
              "bio": {
                "description": "作者简介；不可用时为空字符串。",
                "type": "string"
              },
              "verification_label": {
                "description": "作者认证文案；不可用时为空字符串。",
                "type": "string"
              },
              "verified": {
                "description": "作者是否为认证账号。",
                "type": "boolean"
              },
              "follower_count": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "作者粉丝数；不可用时为 null。"
              },
              "received_upvote_count": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "作者累计获得的赞同数；不可用时为 null。"
              }
            },
            "required": [
              "user_id",
              "name",
              "avatar_url",
              "profile_url",
              "bio",
              "verification_label",
              "verified",
              "follower_count",
              "received_upvote_count"
            ],
            "type": "object",
            "description": "评论回复作者信息。"
          }
        },
        "required": [
          "comment_id",
          "parent_comment_id",
          "reply_to_comment_id",
          "content",
          "publish_time",
          "like_count",
          "is_author_comment",
          "ip_location",
          "author"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "next_page_token": {
      "description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；只用于当前评论回复续页；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。",
      "type": "string"
    },
    "reply_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "该一级评论下的回复总数；不是当前页 items 数量；不可用时为 null。"
    },
    "points": {
      "type": "object",
      "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      "properties": {
        "cost": {
          "type": "integer",
          "description": "本次请求最终确认消耗的积分。",
          "minimum": 0
        },
        "balance": {
          "type": "integer",
          "description": "本次接口完成时看到的当前积分余额。",
          "minimum": 0
        }
      },
      "required": [
        "cost",
        "balance"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "items",
    "next_page_token",
    "reply_count",
    "points"
  ]
}

根据知乎独立视频页或带视频回答页链接提交口播转文字任务；提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。

{
  "type": "object",
  "properties": {
    "video_url": {
      "description": "知乎视频内容页面链接；支持独立视频 https://www.zhihu.com/zvideo/{zvideo_id}，以及带视频回答 https://www.zhihu.com/question/{question_id}/answer/{answer_id}；从搜索结果继续处理 videoanswer 时直接传其非空 content_url。普通无视频回答、专栏文章页、问题页、用户主页、接口地址、短链接和只包含数字的 ID 不可处理。",
      "type": "string"
    }
  },
  "required": [
    "video_url"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "job_id": {
      "description": "任务 ID。",
      "type": "string"
    },
    "status": {
      "description": "任务状态。",
      "enum": [
        "queued",
        "running",
        "succeeded",
        "failed",
        "expired"
      ],
      "type": "string"
    },
    "is_terminal": {
      "description": "是否已终态。",
      "type": "boolean"
    },
    "platform": {
      "description": "任务所属平台。",
      "type": "string"
    },
    "content_id": {
      "description": "平台内容 ID。",
      "type": "string"
    },
    "source_id": {
      "description": "任务来源 ID。",
      "type": "string"
    },
    "content_type": {
      "description": "内容类型。",
      "type": "string"
    },
    "content_meta": {
      "additionalProperties": false,
      "properties": {
        "content_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "作品链接。"
        },
        "title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "作品标题；平台无标题时为 null。"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "平台作品原始描述、正文或配文。"
        },
        "duration_ms": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "description": "音视频时长，单位毫秒。"
        },
        "author": {
          "anyOf": [
            {
              "additionalProperties": false,
              "properties": {
                "user_id": {
                  "description": "作者用户 ID。",
                  "type": "string"
                },
                "name": {
                  "description": "作者昵称。",
                  "type": "string"
                },
                "profile_url": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "作者主页链接。"
                },
                "avatar_url": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "作者头像链接。"
                }
              },
              "required": [
                "user_id",
                "name",
                "profile_url",
                "avatar_url"
              ],
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "description": "作者信息。"
        }
      },
      "required": [
        "content_url",
        "title",
        "description",
        "duration_ms",
        "author"
      ],
      "type": "object",
      "description": "作品上下文信息，便于结合转写内容做口播分析。"
    },
    "transcript": {
      "anyOf": [
        {
          "additionalProperties": false,
          "properties": {
            "text": {
              "description": "完整口播转文字结果。",
              "type": "string"
            },
            "segments": {
              "description": "按时间顺序排列的分段结果。",
              "items": {
                "additionalProperties": false,
                "properties": {
                  "start_ms": {
                    "description": "分段开始时间，单位毫秒。",
                    "minimum": 0,
                    "type": "integer"
                  },
                  "end_ms": {
                    "description": "分段结束时间，单位毫秒。",
                    "minimum": 0,
                    "type": "integer"
                  },
                  "text": {
                    "description": "分段文本。",
                    "type": "string"
                  }
                },
                "required": [
                  "start_ms",
                  "end_ms",
                  "text"
                ],
                "type": "object"
              },
              "type": "array"
            }
          },
          "required": [
            "text",
            "segments"
          ],
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "description": "成功时的口播转文字结果；非终态或失败时为 null。"
    },
    "error": {
      "anyOf": [
        {
          "additionalProperties": false,
          "properties": {
            "code": {
              "description": "稳定错误码。",
              "type": "string"
            },
            "message": {
              "description": "面向用户的错误说明。",
              "type": "string"
            },
            "retryable": {
              "default": false,
              "description": "是否可重试。",
              "type": "boolean"
            }
          },
          "required": [
            "code",
            "message"
          ],
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "description": "失败或过期时的稳定错误结构；非终态或成功时为 null。"
    },
    "next_poll_after_seconds": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "建议下次查询前等待的秒数；非终态时可用。"
    },
    "next_action": {
      "anyOf": [
        {
          "additionalProperties": false,
          "properties": {
            "tool_name": {
              "description": "下一步建议调用的查询工具。",
              "type": "string"
            },
            "job_id": {
              "description": "需要继续查询的 job_id。",
              "type": "string"
            },
            "arguments": {
              "additionalProperties": true,
              "description": "下一步查询工具可直接使用的参数。",
              "type": "object"
            },
            "instruction": {
              "description": "给 AI/客户端的查询指令，说明如何继续轮询到终态。",
              "type": "string"
            }
          },
          "required": [
            "tool_name",
            "job_id",
            "arguments",
            "instruction"
          ],
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "description": "非终态时建议的下一步查询动作。"
    },
    "message": {
      "description": "面向用户/AI 的状态说明。",
      "type": "string"
    }
  },
  "required": [
    "job_id",
    "status",
    "is_terminal",
    "platform",
    "content_id",
    "source_id",
    "content_type",
    "content_meta",
    "transcript",
    "error",
    "next_poll_after_seconds",
    "next_action",
    "message"
  ],
  "additionalProperties": false
}

根据知乎独立视频的数字 zvideo_id 提交口播转文字任务；提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。

{
  "type": "object",
  "properties": {
    "zvideo_id": {
      "description": "知乎独立视频 zvideo_id；用户已提供时原样使用，否则可从独立视频详情结果的 content_id 复制；必须是数字字符串。不要传视频链接、回答 ID、文章 ID 或问题 ID。",
      "type": "string"
    }
  },
  "required": [
    "zvideo_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "job_id": {
      "description": "任务 ID。",
      "type": "string"
    },
    "status": {
      "description": "任务状态。",
      "enum": [
        "queued",
        "running",
        "succeeded",
        "failed",
        "expired"
      ],
      "type": "string"
    },
    "is_terminal": {
      "description": "是否已终态。",
      "type": "boolean"
    },
    "platform": {
      "description": "任务所属平台。",
      "type": "string"
    },
    "content_id": {
      "description": "平台内容 ID。",
      "type": "string"
    },
    "source_id": {
      "description": "任务来源 ID。",
      "type": "string"
    },
    "content_type": {
      "description": "内容类型。",
      "type": "string"
    },
    "content_meta": {
      "additionalProperties": false,
      "properties": {
        "content_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "作品链接。"
        },
        "title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "作品标题；平台无标题时为 null。"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "平台作品原始描述、正文或配文。"
        },
        "duration_ms": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "description": "音视频时长，单位毫秒。"
        },
        "author": {
          "anyOf": [
            {
              "additionalProperties": false,
              "properties": {
                "user_id": {
                  "description": "作者用户 ID。",
                  "type": "string"
                },
                "name": {
                  "description": "作者昵称。",
                  "type": "string"
                },
                "profile_url": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "作者主页链接。"
                },
                "avatar_url": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "作者头像链接。"
                }
              },
              "required": [
                "user_id",
                "name",
                "profile_url",
                "avatar_url"
              ],
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "description": "作者信息。"
        }
      },
      "required": [
        "content_url",
        "title",
        "description",
        "duration_ms",
        "author"
      ],
      "type": "object",
      "description": "作品上下文信息，便于结合转写内容做口播分析。"
    },
    "transcript": {
      "anyOf": [
        {
          "additionalProperties": false,
          "properties": {
            "text": {
              "description": "完整口播转文字结果。",
              "type": "string"
            },
            "segments": {
              "description": "按时间顺序排列的分段结果。",
              "items": {
                "additionalProperties": false,
                "properties": {
                  "start_ms": {
                    "description": "分段开始时间，单位毫秒。",
                    "minimum": 0,
                    "type": "integer"
                  },
                  "end_ms": {
                    "description": "分段结束时间，单位毫秒。",
                    "minimum": 0,
                    "type": "integer"
                  },
                  "text": {
                    "description": "分段文本。",
                    "type": "string"
                  }
                },
                "required": [
                  "start_ms",
                  "end_ms",
                  "text"
                ],
                "type": "object"
              },
              "type": "array"
            }
          },
          "required": [
            "text",
            "segments"
          ],
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "description": "成功时的口播转文字结果；非终态或失败时为 null。"
    },
    "error": {
      "anyOf": [
        {
          "additionalProperties": false,
          "properties": {
            "code": {
              "description": "稳定错误码。",
              "type": "string"
            },
            "message": {
              "description": "面向用户的错误说明。",
              "type": "string"
            },
            "retryable": {
              "default": false,
              "description": "是否可重试。",
              "type": "boolean"
            }
          },
          "required": [
            "code",
            "message"
          ],
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "description": "失败或过期时的稳定错误结构；非终态或成功时为 null。"
    },
    "next_poll_after_seconds": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "建议下次查询前等待的秒数；非终态时可用。"
    },
    "next_action": {
      "anyOf": [
        {
          "additionalProperties": false,
          "properties": {
            "tool_name": {
              "description": "下一步建议调用的查询工具。",
              "type": "string"
            },
            "job_id": {
              "description": "需要继续查询的 job_id。",
              "type": "string"
            },
            "arguments": {
              "additionalProperties": true,
              "description": "下一步查询工具可直接使用的参数。",
              "type": "object"
            },
            "instruction": {
              "description": "给 AI/客户端的查询指令，说明如何继续轮询到终态。",
              "type": "string"
            }
          },
          "required": [
            "tool_name",
            "job_id",
            "arguments",
            "instruction"
          ],
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "description": "非终态时建议的下一步查询动作。"
    },
    "message": {
      "description": "面向用户/AI 的状态说明。",
      "type": "string"
    }
  },
  "required": [
    "job_id",
    "status",
    "is_terminal",
    "platform",
    "content_id",
    "source_id",
    "content_type",
    "content_meta",
    "transcript",
    "error",
    "next_poll_after_seconds",
    "next_action",
    "message"
  ],
  "additionalProperties": false
}

根据用户提供的有效 job_id，或 submit 工具返回的 job_id 查询知乎视频口播转文字任务；每次最多等待 240 秒，不触发重处理，也不要重复提交任务。

{
  "type": "object",
  "properties": {
    "job_id": {
      "description": "口播转文字任务 ID；用户已提供时直接使用，否则使用 zhihu_submit_video_speech_text_by_video_url 或 zhihu_submit_video_speech_text_by_zvideo_id 返回的 job_id；任务未完成时继续原样传入同一个 job_id，不要重复提交。",
      "type": "string"
    }
  },
  "required": [
    "job_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "job_id": {
      "description": "任务 ID。",
      "type": "string"
    },
    "status": {
      "description": "任务状态。",
      "enum": [
        "queued",
        "running",
        "succeeded",
        "failed",
        "expired"
      ],
      "type": "string"
    },
    "is_terminal": {
      "description": "是否已终态。",
      "type": "boolean"
    },
    "platform": {
      "description": "任务所属平台。",
      "type": "string"
    },
    "content_id": {
      "description": "平台内容 ID。",
      "type": "string"
    },
    "source_id": {
      "description": "任务来源 ID。",
      "type": "string"
    },
    "content_type": {
      "description": "内容类型。",
      "type": "string"
    },
    "content_meta": {
      "additionalProperties": false,
      "properties": {
        "content_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "作品链接。"
        },
        "title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "作品标题；平台无标题时为 null。"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "平台作品原始描述、正文或配文。"
        },
        "duration_ms": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "description": "音视频时长，单位毫秒。"
        },
        "author": {
          "anyOf": [
            {
              "additionalProperties": false,
              "properties": {
                "user_id": {
                  "description": "作者用户 ID。",
                  "type": "string"
                },
                "name": {
                  "description": "作者昵称。",
                  "type": "string"
                },
                "profile_url": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "作者主页链接。"
                },
                "avatar_url": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "作者头像链接。"
                }
              },
              "required": [
                "user_id",
                "name",
                "profile_url",
                "avatar_url"
              ],
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "description": "作者信息。"
        }
      },
      "required": [
        "content_url",
        "title",
        "description",
        "duration_ms",
        "author"
      ],
      "type": "object",
      "description": "作品上下文信息，便于结合转写内容做口播分析。"
    },
    "transcript": {
      "anyOf": [
        {
          "additionalProperties": false,
          "properties": {
            "text": {
              "description": "完整口播转文字结果。",
              "type": "string"
            },
            "segments": {
              "description": "按时间顺序排列的分段结果。",
              "items": {
                "additionalProperties": false,
                "properties": {
                  "start_ms": {
                    "description": "分段开始时间，单位毫秒。",
                    "minimum": 0,
                    "type": "integer"
                  },
                  "end_ms": {
                    "description": "分段结束时间，单位毫秒。",
                    "minimum": 0,
                    "type": "integer"
                  },
                  "text": {
                    "description": "分段文本。",
                    "type": "string"
                  }
                },
                "required": [
                  "start_ms",
                  "end_ms",
                  "text"
                ],
                "type": "object"
              },
              "type": "array"
            }
          },
          "required": [
            "text",
            "segments"
          ],
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "description": "成功时的口播转文字结果；非终态或失败时为 null。"
    },
    "error": {
      "anyOf": [
        {
          "additionalProperties": false,
          "properties": {
            "code": {
              "description": "稳定错误码。",
              "type": "string"
            },
            "message": {
              "description": "面向用户的错误说明。",
              "type": "string"
            },
            "retryable": {
              "default": false,
              "description": "是否可重试。",
              "type": "boolean"
            }
          },
          "required": [
            "code",
            "message"
          ],
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "description": "失败或过期时的稳定错误结构；非终态或成功时为 null。"
    },
    "next_poll_after_seconds": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "建议下次查询前等待的秒数；非终态时可用。"
    },
    "next_action": {
      "anyOf": [
        {
          "additionalProperties": false,
          "properties": {
            "tool_name": {
              "description": "下一步建议调用的查询工具。",
              "type": "string"
            },
            "job_id": {
              "description": "需要继续查询的 job_id。",
              "type": "string"
            },
            "arguments": {
              "additionalProperties": true,
              "description": "下一步查询工具可直接使用的参数。",
              "type": "object"
            },
            "instruction": {
              "description": "给 AI/客户端的查询指令，说明如何继续轮询到终态。",
              "type": "string"
            }
          },
          "required": [
            "tool_name",
            "job_id",
            "arguments",
            "instruction"
          ],
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "description": "非终态时建议的下一步查询动作。"
    },
    "message": {
      "description": "面向用户/AI 的状态说明。",
      "type": "string"
    }
  },
  "required": [
    "job_id",
    "status",
    "is_terminal",
    "platform",
    "content_id",
    "source_id",
    "content_type",
    "content_meta",
    "transcript",
    "error",
    "next_poll_after_seconds",
    "next_action",
    "message"
  ],
  "additionalProperties": false
}

查询当前 API Key 账户的 SocialDataX 积分余额、剩余积分或点数 / remaining points balance。需要充值时请访问 https://socialdatax.com/dashboard/billing。

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "additionalProperties": {
    "type": "integer"
  }
}