# 快手用户作品 API

快手用户作品接口（user_posts）因上游故障暂停，调用不计费。

规范地址: https://socialtoai.com/zh/kuaishou-user-posts-api/

## 暂时不可用

该操作因上游供给故障暂停。调用会返回 upstream_error，不扣费；其他操作不受影响。重试前请先确认可用状态。

## 一次请求

成功或空结果每次 1.5 credits，失败不计费。

把 PASTE_PUBLIC 占位符换成受支持的公开标识。这是请求模板，不会自动执行。

```
curl --request POST 'https://api.socialtoai.com/v1/user_posts' \
  --header "X-API-Key: $SOCIALTOAI_API_KEY" \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: REPLACE_WITH_A_UNIQUE_REQUEST_ID' \
  --data '{"platform":"kuaishou","user":"PASTE_PUBLIC_ACCOUNT_ID"}'
```

## 原生支持

结果类型：item。翻页：使用返回的不透明 cursor。

以上取值来自参考卡。用户查找或特定内容类型可能还有额外限制。请以响应里的 applied_params 和 warnings 为准，不要假定不支持的筛选已生效。

## 经过结构校验的示例

暂停期间的拒绝示例，不扣费。

```
{
  "request_id": "example_only_not_a_live_call",
  "schema_version": "v1",
  "fetched_at": "2026-09-05T00:00:00Z",
  "status": "error",
  "applied_params": {},
  "warnings": [],
  "items": [],
  "error": {
    "code": "upstream_error",
    "message": "Temporarily unavailable due to an upstream supply failure. No charge. Do not retry this operation until it is reopened.",
    "retryable": false,
    "action_url": "https://socialtoai.com/pricing/"
  },
  "platform": "kuaishou",
  "billing": {
    "cost": 0,
    "balance": 2,
    "unit": "credits",
    "pricing": "standard"
  }
}
```

## 平台限制

搜索只支持 content_type=all。用户资料和创作者作品需要数字用户 ID；kwaiId、eid 和主页链接不会被隐式解析。

当前生产链路不支持 v.kuaishou.com 分享链接，请使用数字作品 ID 或标准作品链接。

用户查找可在当前页内继续，不承诺原生的下一页查找。相邻重复的内容结果会被省略并附带 warning。

热榜支持下方列出的四个分类，其他分类会回退并附带 warning。

空评论和识别出的直播卡片会被省略并附带 warning；不安全的 HTTP 媒体链接会被省略。

[快手全部接口 →](https://socialtoai.com/zh/platforms/kuaishou/)