TikTok

The TikTok connector exposes these endpoints:

Endpoint	Purpose	Billed
GET /v1/tiktok/search	Keyword search across videos, users, or hashtags, relevance-ranked	per page
GET /v1/tiktok/post/{video_id}	Full post details + all engagement metrics	per request
GET /v1/tiktok/post/{video_id}/comments	A post's comments, with nested replies	per page
GET /v1/tiktok/user/{username}	A public profile with follower/like/video totals	per request
GET /v1/tiktok/user/{username}/videos	A user's videos, newest first	per page
GET /v1/tiktok/hashtag/{challenge_id}/videos	Videos tagged with a hashtag	per page
GET /v1/tiktok/music/{music_id}/videos	Videos using a given sound	per page
GET /v1/tiktok/trending	The current For You feed	per page

Identifiers at a glance

To call…	You need…	Get it from…
user profile / videos	a username (@handle)	anywhere a TikTok link appears
hashtag videos	a numeric hashtag id	search with type=hashtag (the id)
sound videos	a numeric sound id	any post's music.id
comments	a video id	a video URL or search

Post identifiers

A post is identified by its numeric video id — the number in a video URL:

https://www.tiktok.com/@user/video/7523456789012345678
                                    └──────────────────┘
                                     video_id = 7523456789012345678

You can pass either the bare id (7523456789012345678) or a full video URL — the API normalises it.

Media types

type	Meaning
video	Standard TikTok video
photo	Photo-mode post (image carousel)

Engagement vocabulary

TikTok's own metric names differ from other platforms. ListenX surfaces them under stable keys:

Field	TikTok meaning
play_count	Video plays / views
digg_count	Likes
comment_count	Comments
share_count	Shares
collect_count	Saves (favourites)
repost_count	Reposts