# TikTok creator recent posts

- API version: 1.11.0
- Last updated: 2026-11-16
- Server: `https://api.ailingtu.com`
- Web document: [TikTok creator recent posts](/en/openapi/creator-analysis-tiktok)
- Full schema: [JSON Schema](/en/openapi/operations/fetchTikTokCreatorPosts.json)
- Discovery: [Operation index](/en/openapi/operations/index.json)

## GET /v1/influencer/fetchPosts

Operation ID: `fetchTikTokCreatorPosts`

Fetch a public TikTok creator profile and recent post views, likes, comments, shares, and saves for creator analysis or monitoring.

Authentication: Request header `x-api-key: <YOUR_API_KEY>`; keep the key on the server and never expose it in client code, logs or shared files.

Success criteria: Check the HTTP status and the matching response structure.

### Request parameters

| Field | Location | Type | Required | Description |
|---|---|---|---|---|
| `uniqueId` | query | string | Yes | TikTok creator username without the leading @ |
| `count` | query | integer | No | Number of recent posts to return; defaults to 40 |

### Success response

```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
}
```

### Integration notes and limits

- This operation currently returns TikTok creator data. Do not infer accounts on other platforms from matching usernames.
- Treat the request as successful only when HTTP is 200 and code is 0. code -1 means no public creator posts were available.
- To generate an AI creator report, turn this response into evidence and send it to /v1/relay/chat/completions.

### Error handling

| HTTP | Description |
|---|---|
| 400 | The request parameters or body are invalid. Fix them and retry. |
| 401 | The API key is missing or invalid. Check x-api-key. |
| 403 | The API key has no permission to call this endpoint. |
| 429 | Too many requests. Retry with exponential backoff. |
| 500 | The server failed. Retry transient failures with exponential backoff. |

Treat any non-zero business code as a failure. Do not blindly retry parameter, permission or authorization errors. If creating a publishing or generation task times out, query the existing task first instead of creating another one.

### Related endpoints

- [AI Model API](/en/openapi/ai-model-api) · [Markdown](/en/openapi/operations/createRelayChatCompletion.md)
