spike-faye-lei TikTok
Overview
Short-video social platform. Content platform archetype.
Workflows
Search videos
searchVideos(keyword)→id,desc,author.uniqueId, stats- Paginate: use
cursorfrom response asoffsetin next call whilehas_more= 1
Search and explore a user
searchUsers(keyword)→user_info.uid,unique_id,nickname,follower_countgetUserProfile(username)→ full profile →id(numeric userId)getUserVideos(username)→ paginated uploads →id(videoId), stats
Get video detail and comments
getVideoDetail(username, videoId)→ full metadata, stats,author.uniqueIdgetVideoComments(username, videoId)→ comments →cid(commentId), author, likes,reply_countgetCommentReplies(item_id=videoId, comment_id=cid)→ threaded replies
Discover trending content
getHomeFeed()→ recommended/trending videos →id,author.uniqueIdgetExplore()→ trending videos from Explore page →id,author.uniqueId
Explore hashtags
getHashtagDetail(challengeName)→challenge.id,stats.videoCount,stats.viewCountgetHashtagVideos(hashtag)→ videos using the hashtag →id, stats
Related videos
getVideoDetail(username, videoId)→ confirm video existsgetRelatedVideos(username, videoId)→ recommended next videos →id
Like / unlike a video
searchVideos(keyword)orgetHomeFeed()→ pick video →idlikeVideo(videoId=id)→ like the videounlikeVideo(videoId=id)→ reverse the like
Follow / unfollow a user
getUserProfile(username)→id(numeric userId)followUser(userId=id)→ follow the userunfollowUser(userId=id)→ reverse the follow
Block / unblock a user
getUserProfile(username)→id(numeric userId)blockUser(userId=id)→ block the userunblockUser(userId=id)→ reverse the block
Bookmark / unbookmark a video
searchVideos(keyword)orgetVideoDetail(username, videoId)→idbookmarkVideo(videoId=id)→ add video to favoritesunbookmarkVideo(videoId=id)→ remove from favorites
Comment on a video
getVideoDetail(username, videoId)→ confirm video →idcreateComment(videoId=id, text)→ post a comment →commentIddeleteComment(videoId=id, commentId)→ delete own comment
Reply to a comment
getVideoComments(username, videoId)→ find comment →cid(commentId)replyComment(videoId, commentId=cid, text)→ post reply →commentId
Like / unlike a comment
getVideoComments(username, videoId)→ find comment →cid(commentId)likeComment(videoId, commentId=cid)→ like the commentunlikeComment(videoId, commentId=cid)→ reverse the like
Operations
| Operation | Intent | Key Input | Key Output | Notes |
|---|---|---|---|---|
| searchVideos | search videos by keyword | keyword | id, desc, author.uniqueId, stats | paginated via offset/cursor |
| searchUsers | search users by keyword | keyword | user_info.uid, unique_id, nickname, follower_count | paginated via cursor |
| getVideoDetail | get video details | username, videoId | description, stats, music, author, challenges | SSR extraction from video page |
| getUserProfile | get user profile | username | id, followers, following, bio, video count, verified | SSR extraction, id needed for follow/block |
| getUserVideos | get user's uploads | username | id (videoId), description, stats | adapter op, paginated |
| getVideoComments | get comments on a video | username, videoId | cid, text, author, digg_count, reply_count | API interception from video page |
| getCommentReplies | get replies to a comment | item_id <- getVideoComments, comment_id <- getVideoComments.cid | cid, text, author, digg_count | paginated via cursor |
| getHomeFeed | get trending/recommended | — | id, desc, author, stats | API interception from For You feed |
| getExplore | get explore/discover videos | — | id, desc, author, stats | API interception from Explore page |
| getHashtagDetail | get hashtag info | challengeName | challenge.id, stats.videoCount, stats.viewCount | |
| getHashtagVideos | get videos for hashtag | hashtag | id, description, stats | adapter op |
| getRelatedVideos | get related videos | username, videoId <- getVideoDetail | id, description | adapter op |
| likeVideo | like a video | videoId <- searchVideos/getHomeFeed | success, is_digg | write, caution |
| unlikeVideo | unlike a video | videoId <- likeVideo source | success, is_digg | write, reverse of likeVideo |
| followUser | follow a user | userId <- getUserProfile.id | success, follow_status | write, caution |
| unfollowUser | unfollow a user | userId <- getUserProfile.id | success, follow_status | write, reverse of followUser |
| blockUser | block a user | userId <- getUserProfile.id | success | write, caution |
| unblockUser | unblock a user | userId <- getUserProfile.id | success | write, reverse of blockUser |
| bookmarkVideo | bookmark a video | videoId <- searchVideos/getVideoDetail | success | write, caution |
| unbookmarkVideo | unbookmark a video | videoId <- bookmarkVideo source | success | write, reverse of bookmarkVideo |
| createComment | post a comment | videoId <- getVideoDetail, text | success, commentId | write, caution |
| deleteComment | delete a comment | videoId, commentId <- createComment | success | write, must be comment author |
| replyComment | reply to a comment | videoId, commentId <- getVideoComments.cid, text | success, commentId | write, caution |
| likeComment | like a comment | videoId, commentId <- getVideoComments.cid | success, is_digg | write, caution |
| unlikeComment | unlike a comment | videoId, commentId <- getVideoComments.cid | success, is_digg | write, reverse of likeComment |
Quick Start
# Search for cooking videos
openweb tiktok exec searchVideos '{"keyword":"cooking"}'
# Paginate (use cursor from previous response as offset)
openweb tiktok exec searchVideos '{"keyword":"cooking","offset":12,"count":5}'
# Search for users
openweb tiktok exec searchUsers '{"keyword":"charlidamelio"}'
# Get video details
openweb tiktok exec getVideoDetail '{"username":"tiktok","videoId":"7626810027520593183"}'
# Get user profile
openweb tiktok exec getUserProfile '{"username":"charlidamelio"}'
# Get a user's uploaded videos
openweb tiktok exec getUserVideos '{"username":"tiktok"}'
# Get video comments
openweb tiktok exec getVideoComments '{"username":"tiktok","videoId":"7626810027520593183"}'
# Get replies to a comment
openweb tiktok exec getCommentReplies '{"item_id":"7626810027520593183","comment_id":"7626813820006859527"}'
# Get trending/recommended videos
openweb tiktok exec getHomeFeed '{}'
# Get explore page videos
openweb tiktok exec getExplore '{}'
# Get hashtag detail
openweb tiktok exec getHashtagDetail '{"challengeName":"cooking"}'
# Get videos for a hashtag
openweb tiktok exec getHashtagVideos '{"hashtag":"cooking"}'
# Get related videos
openweb tiktok exec getRelatedVideos '{"username":"tiktok","videoId":"7626810027520593183"}'
# Like a video (videoId from search/feed)
openweb tiktok exec likeVideo '{"videoId":"7626810027520593183"}'
# Unlike a video
openweb tiktok exec unlikeVideo '{"videoId":"7626810027520593183"}'
# Follow a user (numeric userId from getUserProfile)
openweb tiktok exec followUser '{"userId":"107955"}'
# Unfollow a user
openweb tiktok exec unfollowUser '{"userId":"107955"}'
# Block a user (numeric userId from getUserProfile)
openweb tiktok exec blockUser '{"userId":"107955"}'
# Unblock a user
openweb tiktok exec unblockUser '{"userId":"107955"}'
# Bookmark a video
openweb tiktok exec bookmarkVideo '{"videoId":"7626810027520593183"}'
# Unbookmark a video
openweb tiktok exec unbookmarkVideo '{"videoId":"7626810027520593183"}'
# Post a comment
openweb tiktok exec createComment '{"videoId":"7626810027520593183","text":"Great video!"}'
# Delete a comment
openweb tiktok exec deleteComment '{"videoId":"7626810027520593183","commentId":"7345678901234567891"}'
# Reply to a comment (commentId from getVideoComments)
openweb tiktok exec replyComment '{"videoId":"7626810027520593183","commentId":"7626813820006859527","text":"Great point!"}'
# Like a comment (commentId from getVideoComments)
openweb tiktok exec likeComment '{"videoId":"7626810027520593183","commentId":"7626813820006859527"}'
# Unlike a comment
openweb tiktok exec unlikeComment '{"videoId":"7626810027520593183","commentId":"7626813820006859527"}'