eternalsocial.dev
TikTok

Get TikTok posts

POST
/api/tiktok/posts

Authorization

bearerAuth
AuthorizationBearer <token>

JWT token from /auth/login or API key from /keys

In: header

Request Body

application/json

username*string
Length1 <= length
maxPosts?number

Maximum number of posts to fetch. Charged per 10 posts.

Default20
Range1 <= value <= 1000
oldestDate?number

Filter posts until this timestamp (milliseconds)

webhookUrl?string

Webhook URL to receive results. If provided, request returns immediately.

Formaturi

Response Body

application/json

application/json

application/json

curl -X POST "http://localhost:3222/api/tiktok/posts" \  -H "Content-Type: application/json" \  -d '{    "username": "tiktok"  }'
{
  "success": true,
  "requestId": "string",
  "data": [
    {
      "id": "string",
      "desc": "string",
      "createTime": 0,
      "video": {
        "id": "string",
        "cover": "string",
        "originCover": "string",
        "dynamicCover": "string",
        "playAddr": "string",
        "downloadAddr": "string",
        "duration": 0,
        "width": 0,
        "height": 0,
        "ratio": "string",
        "format": "string",
        "bitrate": 0
      },
      "author": {
        "id": "string",
        "uniqueId": "string",
        "nickname": "string",
        "avatarThumb": "string",
        "avatarMedium": "string",
        "avatarLarger": "string",
        "signature": "string",
        "verified": true,
        "secUid": "string",
        "openFavorite": true,
        "privateAccount": true
      },
      "music": {
        "id": "string",
        "title": "string",
        "authorName": "string",
        "playUrl": "string",
        "coverThumb": "string",
        "coverMedium": "string",
        "coverLarge": "string",
        "duration": 0,
        "original": true,
        "album": "string"
      },
      "challenges": [
        {
          "id": "string",
          "title": "string",
          "desc": "string",
          "profileThumb": "string",
          "profileMedium": "string",
          "profileLarger": "string",
          "isCommerce": true
        }
      ],
      "stats": {
        "playCount": "string",
        "diggCount": "string",
        "commentCount": "string",
        "shareCount": "string",
        "collectCount": "string",
        "repostCount": "string"
      },
      "duetInfo": {
        "duetFromId": "string"
      },
      "originalItem": true,
      "officalItem": true,
      "textExtra": [
        {
          "awemeId": "string",
          "start": 0,
          "end": 0,
          "hashtagName": "string",
          "hashtagId": "string",
          "type": 0,
          "userId": "string",
          "userUniqueId": "string"
        }
      ],
      "isAd": true,
      "shareUrl": "string"
    }
  ],
  "itemCount": 0,
  "creditsCharged": 0
}
{
  "success": true,
  "requestId": "string",
  "status": "processing",
  "message": "string"
}
{
  "success": false,
  "error": "string",
  "requestId": "string"
}