Every call reads TikTok now and returns TikTok’s own JSON, unmodified. All are GET with query parameters,
charged per request. Base URL: https://api.datasocial.ai.
Use the Data API first: it is cheaper and covers billions of rows. Use Live for what the warehouse
doesn’t have yet, or when you need it this second.
Things that trip people up
- Ids exceed 2^53. Read them as strings (
id_str, uid), never as JavaScript numbers.
- Video duration is in milliseconds; sound duration is in seconds.
- Cover and play URLs expire within hours. Store the id, not the URL.
* = required.
| Endpoint |
What it returns |
Parameters |
/v1/live/user/posts |
A creator’s videos, newest first, with the full author object |
user_id*, count, max_cursor, min_cursor |
/v1/live/user/info |
Full profile detail for one creator |
user_id*, sec_user_id |
/v1/live/user/followers |
A creator’s followers |
user_id*, sec_user_id, count, max_time |
/v1/live/user/following |
The accounts a creator follows |
user_id*, sec_user_id, count, max_time |
/v1/live/user/recommended |
Accounts TikTok recommends alongside a creator |
user_id*, sec_user_id, count |
| Endpoint |
What it returns |
Parameters |
/v1/live/video/info |
Full detail for one video |
aweme_id* |
/v1/live/video/comments |
Top-level comments on a video |
aweme_id*, count, cursor |
/v1/live/video/comments/replies |
Replies under one comment |
aweme_id*, comment_id*, count, cursor |
| Endpoint |
What it returns |
Parameters |
/v1/live/music/info |
Detail for one sound |
music_id* |
/v1/live/music/posts |
Popular videos using a sound |
music_id*, count, cursor |
/v1/live/music/posts/fresh |
Newest videos using a sound |
music_id*, count, cursor |
/v1/live/music/trending |
TikTok’s trending sounds chart |
count, cursor |
/v1/live/music/related |
Sounds recommended for a video |
aweme_id*, count, cursor |
| Endpoint |
What it returns |
Parameters |
/v1/live/hashtag/search |
Hashtags matching a keyword |
keyword*, count, cursor |
/v1/live/hashtag/info |
Detail for one hashtag |
hashtag_id* |
/v1/live/hashtag/posts |
Popular videos under a hashtag |
hashtag_id*, count, cursor |
/v1/live/hashtag/posts/fresh |
Newest videos under a hashtag |
hashtag_id*, count, cursor |
| Endpoint |
What it returns |
Parameters |
/v1/live/search/videos |
Videos matching a keyword |
keyword*, count, offset |
/v1/live/search/general |
Mixed results: users, videos and hashtags |
keyword*, count, offset |
/v1/live/search/music |
Sounds matching a keyword |
keyword*, count, cursor |
/v1/live/search/users |
Creators matching a keyword |
keyword*, count, cursor |
| Endpoint |
What it returns |
Parameters |
/v1/live/trending/categories |
TikTok’s trending category shelves |
count, cursor |
/v1/live/trending/effects |
Trending camera effects, as a video feed |
count, cursor |
/v1/live/feed |
The For You feed, as an anonymous visitor |
count, max_cursor |