# TikTok 达人近期作品

- API 版本：1.10.0
- 最后更新：2026-09-29
- 服务地址：`https://api.ailingtu.com`
- 网页文档：[TikTok 达人近期作品](/openapi/creator-analysis-tiktok)
- 完整接口约束：[JSON Schema](/openapi/operations/fetchTikTokCreatorPosts.json)
- 接口发现：[接口索引](/openapi/operations/index.json)

## GET /v1/influencer/fetchPosts

接口标识：`fetchTikTokCreatorPosts`

按 TikTok 达人 uniqueId 获取公开账号信息及近期作品的播放、点赞、评论、分享和收藏数据，可用于达人分析与监控。

鉴权：请求头 `x-api-key: <YOUR_API_KEY>`；密钥仅保存在服务端。

成功判断：检查 HTTP 状态与对应的响应结构。

### 请求参数

| 字段 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| `uniqueId` | query | string | 是 | TikTok 达人用户名，不含开头的 @ |
| `count` | query | integer | 否 | 返回的近期作品数量，默认 40 |

### 成功响应

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "authorInfo": {
      "id": "6614519312189947909",
      "uniqueId": "vacbirdusa",
      "nickname": "Vacbird",
      "signature": "Product finds and everyday solutions",
      "followerCount": 101037,
      "followingCount": 29,
      "awemeCount": 2573,
      "totalFavorited": 644435
    },
    "posts": [
      {
        "videoId": "7634589785687854366",
        "desc": "A useful product find #musthave",
        "createTime": 1777662000,
        "duration": 18100,
        "isAd": false,
        "cover": "https://cdn.example.com/tiktok-cover.jpg",
        "stats": {
          "playCount": 10844609,
          "diggCount": 46314,
          "commentCount": 552,
          "shareCount": 16457,
          "collectCount": 16257,
          "repostCount": 0
        }
      }
    ],
    "cursor": "1",
    "hasMore": true
  },
  "timestamp": 1787417005
}
```

### 接入说明与限制

- 该接口当前用于 TikTok 达人数据；不要通过同名用户名推断其他平台账号。
- HTTP 200 且 code=0 才表示成功；code=-1 表示未获取到公开达人作品数据。
- AI 达人报告可将本接口结果整理成证据，再调用 /v1/relay/chat/completions 生成。

### 错误处理

| HTTP | 说明 |
|---|---|
| 400 | 请求参数或请求体无效，请修正后重试。 |
| 401 | API 密钥缺失或无效，请检查 x-api-key。 |
| 403 | API 密钥没有此接口的调用权限。 |
| 429 | 请求过于频繁，请采用指数退避重试。 |
| 500 | 服务端发生错误；对于暂时性故障采用指数退避重试。 |

业务 code 非零时也应按失败处理。不要对参数、权限或授权错误盲目重试。创建发布或生成任务超时后先查询原任务，避免重复创建。

### 相关接口

- [AI 模型调用](/openapi/ai-model-api) · [Markdown](/openapi/operations/createRelayChatCompletion.md)