您的浏览器不支持JavaScript,请启用JavaScript以获得最佳体验。
TikTok creator recent posts
Developer docs / Creator analysis

TikTok creator recent posts

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

GET/v1/influencer/fetchPosts
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.

Query parameters

FieldTypeRequiredDescription
uniqueIdstringYesTikTok creator username without the leading @
countintegerNoNumber of recent posts to return; defaults to 40
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.
Success response
{
  "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
}

Response and errors

Main response fields come from the published contract; see the JSON Schema. Required refers to the constraint in the containing object.

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

Fix parameter, permission or authorization errors before retrying. If task creation times out, query existing tasks first and do not submit duplicates after an interrupted poll.

Last updated · 2026-11-16