TikTok

The TikTok connector exposes two endpoints:

Endpoint	Purpose	Billed
GET /v1/tiktok/search	Keyword search across videos, users, or hashtags (native relevance)	per page
GET /v1/tiktok/post/{video_id}	Full post details + all engagement metrics	per request

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