Skip to main content
POST
/
crawl
/
tiktok
/
posts
List TikTok posts
curl --request POST \
  --url https://api.crawlkit.sh/v1/crawl/tiktok/posts \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "username": "<string>",
  "cursor": 0,
  "secUid": "<string>",
  "options": {
    "timeout": 60500
  }
}
'
{
  "success": true,
  "data": {
    "posts": [
      {
        "id": "<string>",
        "description": "<string>",
        "createdAt": "<string>",
        "author": {
          "id": "<string>",
          "username": "<string>",
          "nickname": "<string>",
          "avatar": "<string>",
          "verified": true
        },
        "music": {
          "title": "<string>",
          "author": "<string>",
          "album": "<string>",
          "duration": 123,
          "coverUrl": "<string>"
        },
        "video": {
          "duration": 123,
          "coverUrl": "<string>",
          "width": 123,
          "height": 123
        },
        "stats": {
          "plays": 123,
          "likes": 123,
          "comments": 123,
          "shares": 123,
          "saves": 123,
          "reposts": 123
        },
        "hashtags": [
          {
            "id": "<string>",
            "title": "<string>"
          }
        ],
        "locationCreated": "<string>",
        "isAd": true
      }
    ],
    "pagination": {
      "cursor": "<string>",
      "hasMore": true,
      "total": 123,
      "secUid": "<string>"
    },
    "timing": {
      "total": 123
    },
    "creditsUsed": 123,
    "creditsRemaining": 123
  }
}

Authorizations

Authorization
string
header
required

API key with 'ApiKey ' prefix (e.g., ApiKey ck_...)

Body

application/json
username
string
required

TikTok username (e.g., "nike" or "@nike")

Required string length: 1 - 100
cursor
integer
default:0

Pagination cursor from previous response (0 for first page)

Required range: x >= 0
secUid
string

SecUid from previous response (speeds up pagination by skipping profile lookup)

options
object

Response

Default Response

success
enum<boolean>
required
Available options:
true
data
object
required