Skip to main content
GET
Get a TikTok user's posts (live)

Authorizations

Authorization
string
header
required

XPOZ API access key, created from the dashboard or POST /api/tokens. Send as Authorization: Bearer <access key>.

Path Parameters

identifier
string
required

TikTok username, without the leading @.

Query Parameters

fields
enum<string>[]

TikTok post fields to return. Comma-separated. Allowed values: id, postType, isPrivate, videoThumbnail, description, descriptionLanguage, userId, username, nickname, collectCount, commentCount, likeCount, downloadCount, forwardCount, playCount, hashtags, duration, videoUrl, transcriptsJson, createdAt, createdAtTimestamp, createdAtDate.

Available options:
id,
postType,
isPrivate,
videoThumbnail,
description,
descriptionLanguage,
userId,
username,
nickname,
collectCount,
commentCount,
likeCount,
downloadCount,
forwardCount,
playCount,
hashtags,
duration,
videoUrl,
transcriptsJson,
createdAt,
createdAtTimestamp,
createdAtDate
cursor
string

Opaque cursor from next_page_cursor of the previous page.

Response

One page of results.

Envelope for on-demand /live endpoints: one provider page plus a cursor.

results
object[]
required
count
integer
required
dataSource
enum<string>
required

Where the results came from.

Available options:
database,
api,
hybrid
has_more
boolean
required
next_page_cursor
string | null
required