TikTok MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on TikTok: 36 typed functions through one MCP server. No TikTok API key needed.
- Site
- tiktok.com
- Functions
- 36
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for TikTok alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/tiktokOne MCP server for TikTok and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
getHashtagA hashtag's own facts, view count, description, whether it is currently promoted, off its own page.Arguments
Name Type Required namestringYes Returns
tiktokHashtaginterface tiktokHashtag { id: string; name: string; description: string; viewCount: number; promoted: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/getHashtagCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.getHashtag({ name: "coffee" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.getHashtag({"name": "coffee"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/getHashtag \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"name":"coffee"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.getHashtag({ name: "coffee" });getOwnProfileThe signed-in caller's own account facts.Arguments
Name Type Required argsGetOwnProfileArgsYes type GetOwnProfileArgs = Record<string, never>;Returns
tiktokOwnProfileinterface tiktokOwnProfile { uniqueId?: string; nickname?: string; signature?: string; emailBound?: boolean; mobileBound?: boolean; privateAccount?: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/getOwnProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.getOwnProfile();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.getOwnProfile())curl -X POST https://api.bowmark.ai/v1/sites/tiktok/getOwnProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.getOwnProfile();getProfileA creator's own profile as TikTok's server-rendered page carries it.Arguments
Name Type Required usernamestringYes Returns
tiktokProfileinterface tiktokProfile { id: string; uniqueId: string; nickname: string; signature: string; verified: boolean; privateAccount: boolean; secUid: string; avatar?: string; bioLink?: string; followerCount: number; followingCount: number; videoCount: number; heartCount: number; createTime?: number; friendCount: number; likedVideoCount: number; isBusinessAccount: boolean; isSeller: boolean; isOrganization: boolean; category?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/getProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.getProfile({ username: "mrbeast" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.getProfile({"username": "mrbeast"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/getProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"username":"mrbeast"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.getProfile({ username: "mrbeast" });getSoundA sound/music track's own facts.Arguments
Name Type Required soundIdstringYes Returns
tiktokSoundinterface tiktokSound { id: string; title: string; artist: string; duration: number; videoCount: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/getSoundCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.getSound({ soundId: "7683649837933497118" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.getSound({"soundId": "7683649837933497118"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/getSound \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"soundId":"7683649837933497118"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.getSound({ soundId: "7683649837933497118" });getTranscriptA video's own caption track, read off itemStruct.video.subtitleInfos.Arguments
Name Type Required videostringYes Returns
tiktokTranscriptinterface tiktokTranscriptSegment { startSeconds: number; endSeconds: number; text: string; } interface tiktokTranscript { videoId: string; language: string; segments: tiktokTranscriptSegment[]; fullText: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/getTranscriptCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.getTranscript({ video: "7683649763480309022" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.getTranscript({"video": "7683649763480309022"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/getTranscript \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"video":"7683649763480309022"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.getTranscript({ video: "7683649763480309022" });getVideoOne video's own facts, off the watch page's embedded state: url, caption, hashtags, mentions, create time, duration, stats (plays, likes, comments…Arguments
Name Type Required videostringA /@<handle>/video/<id> or /@<handle>/photo/<id> URL, or a bare numeric id.Yes litebooleanTrue reads TikTok's phone render instead: about half the bytes, but without isAd, duetEnabled, stitchEnabled, stats.repostCount and music.original.No Returns
tiktokVideointerface tiktokVideo { id: string; url: string; /** "photo" for a photo (slideshow) post. */ type: "video" | "photo"; /** A photo post's images in order; absent on a video. A photo post has no videoUrl or playAddr. */ imageUrls?: string[]; caption: string; hashtags: string[]; mentions: string[]; createTime: number; duration: number; stats: { playCount: number; diggCount: number; commentCount: number; shareCount: number; collectCount: number; repostCount?: number; }; author: { id: string; uniqueId: string; nickname: string; followerCount: number; heartCount: number; videoCount: number; verified: boolean; secUid: string; avatar?: string; }; music: { id: string; title: string; playUrl?: string; authorName?: string; original?: boolean; }; coverUrl?: string; playAddr?: string; videoUrl?: string; region?: string; brandOrganicType?: string; /** The place the creator tagged; absent with no location tag. */ location?: { id: string; name: string; address?: string; city?: string; category?: string; subcategory?: string; }; /** TikTok shows its "Paid partnership" label (adLabelVersion 2). Not the same as isAd. */ isPaidPartnership: boolean; /** Partner handles without "@"; empty unless isPaidPartnership. */ sponsors: string[]; /** "partner-tag" = TikTok named the partner on the label; "caption-mentions" = it did * not (the usual case) and these are the caption's @-mentions. Absent when sponsors is empty. */ sponsorsSource?: "partner-tag" | "caption-mentions"; /** TikTok shows its "Promotional content" label (the creator's own brand). */ isPromotionalContent: boolean; showAigcLabel: boolean; isAd?: boolean; duetEnabled: boolean; stitchEnabled: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/getVideoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.getVideo({ video: "7683649763480309022" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.getVideo({"video": "7683649763480309022"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/getVideo \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"video":"7683649763480309022"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.getVideo({ video: "7683649763480309022" });listBookmarkedVideosThe signed-in caller's own saved (Favorites) videos.Arguments
Name Type Required countnumberNo Returns
{ videos: tiktokVideoSummary[]; hasMore: boolean }interface tiktokVideoSummary { id: string; caption: string; playCount?: number; coverUrl?: string; playAddr?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/listBookmarkedVideosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.listBookmarkedVideos({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.listBookmarkedVideos({}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/listBookmarkedVideos \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.listBookmarkedVideos({});listCaptionTracksWhich languages a video's captions are available in and which TikTok shows by default.Arguments
Name Type Required videostringYes Returns
tiktokCaptionTrack[]interface tiktokCaptionTrack { languageCode: string; name: string; isAutoGenerated: boolean; isDefault: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/listCaptionTracksCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.listCaptionTracks({ video: "7683649763480309022" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.listCaptionTracks({"video": "7683649763480309022"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/listCaptionTracks \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"video":"7683649763480309022"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.listCaptionTracks({ video: "7683649763480309022" });listCommentRepliesThe replies under one comment thread, hidden behind TikTok's "N replies" button and absent from listComments' own rows.Arguments
Name Type Required videostringYes commentIdstringYes Returns
tiktokCommentReply[]interface tiktokCommentReply { id: string; text: string; author: { id: string; uniqueId: string; nickname: string; }; likeCount: number; createTime: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/listCommentRepliesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.listCommentReplies({ video: "7683649763480309022", commentId: "7683722202101515021" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.listCommentReplies({ "video": "7683649763480309022", "commentId": "7683722202101515021" }))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/listCommentReplies \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"video":"7683649763480309022","commentId":"7683722202101515021"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.listCommentReplies({ video: "7683649763480309022", commentId: "7683722202101515021" });listCommentsThe first 20 comments under a video.Arguments
Name Type Required videostringYes Returns
tiktokComment[]interface tiktokComment { id: string; text: string; author: { id: string; uniqueId: string; nickname: string; secUid?: string; avatar?: string; }; likeCount: number; replyCount: number; createTime: number; isLikedByAuthor: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/listCommentsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.listComments({ video: "7683649763480309022" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.listComments({"video": "7683649763480309022"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/listComments \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"video":"7683649763480309022"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.listComments({ video: "7683649763480309022" });listConversationsThe signed-in caller's own DM inbox.Arguments
Name Type Required countnumberNo Returns
{ conversations: Array<{ username?: string; nickname?: string; lastMessage?: string; unread?: boolean }> }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/listConversationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.listConversations({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.listConversations({}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/listConversations \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.listConversations({});listFollowersThe accounts that follow a creator, in getProfile's shape (handle, nickname, bio, secUid, avatar, verified/private flags, exact follower, following…Arguments
Name Type Required usernamestringA handle ("nasa"), "@nasa", or a tiktok.com/@nasa URL.No secUidstringThe account's secUid (off getProfile or searchUsers); skips the profile page.No limitnumber1-200, default 30 (one page).No Returns
tiktokProfile[]interface tiktokProfile { id: string; uniqueId: string; nickname: string; signature: string; verified: boolean; privateAccount: boolean; secUid: string; avatar?: string; bioLink?: string; followerCount: number; followingCount: number; videoCount: number; heartCount: number; createTime?: number; friendCount: number; likedVideoCount: number; isBusinessAccount: boolean; isSeller: boolean; isOrganization: boolean; category?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/listFollowersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.listFollowers({ username: "nasa" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.listFollowers({"username": "nasa"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/listFollowers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"username":"nasa"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.listFollowers({ username: "nasa" });listFollowingThe accounts a creator follows, in getProfile's shape, 30 per page up to 200.Arguments
Name Type Required usernamestringA handle ("nasa"), "@nasa", or a tiktok.com/@nasa URL.No secUidstringThe account's secUid (off getProfile or searchUsers); skips the profile page.No limitnumber1-200, default 30 (one page).No Returns
tiktokProfile[]interface tiktokProfile { id: string; uniqueId: string; nickname: string; signature: string; verified: boolean; privateAccount: boolean; secUid: string; avatar?: string; bioLink?: string; followerCount: number; followingCount: number; videoCount: number; heartCount: number; createTime?: number; friendCount: number; likedVideoCount: number; isBusinessAccount: boolean; isSeller: boolean; isOrganization: boolean; category?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/listFollowingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.listFollowing({ username: "nasa" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.listFollowing({"username": "nasa"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/listFollowing \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"username":"nasa"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.listFollowing({ username: "nasa" });listFollowingFeedThe signed-in viewer's Following feed.Arguments
Name Type Required argsListFollowingFeedArgsYes type ListFollowingFeedArgs = Record<string, never>;Returns
tiktokVideoSummary[]interface tiktokVideoSummary { id: string; caption: string; playCount?: number; coverUrl?: string; playAddr?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/listFollowingFeedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.listFollowingFeed();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.listFollowingFeed())curl -X POST https://api.bowmark.ai/v1/sites/tiktok/listFollowingFeed \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.listFollowingFeed();listForYouFeedThe signed-in viewer's own For You feed, the same personalised ranking /foryou shows in a browser.Arguments
Name Type Required argsListForYouFeedArgsYes type ListForYouFeedArgs = Record<string, never>;Returns
tiktokVideoSummary[]interface tiktokVideoSummary { id: string; caption: string; playCount?: number; coverUrl?: string; playAddr?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/listForYouFeedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.listForYouFeed();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.listForYouFeed())curl -X POST https://api.bowmark.ai/v1/sites/tiktok/listForYouFeed \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.listForYouFeed();listHashtagVideosThe videos under one hashtag, newest or top, paged.Arguments
Name Type Required namestringYes Returns
tiktokVideoSummary[]interface tiktokVideoSummary { id: string; caption: string; playCount?: number; coverUrl?: string; playAddr?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/listHashtagVideosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.listHashtagVideos({ name: "coffee" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.listHashtagVideos({"name": "coffee"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/listHashtagVideos \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"name":"coffee"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.listHashtagVideos({ name: "coffee" });listLikedVideosThe videos a creator has liked, from the public Liked tab on their profile (id, caption, play count, cover, play address; newest 15 at most).Arguments
Name Type Required usernamestringYes limitnumberNo Returns
tiktokVideoListinterface tiktokVideoList { videos: tiktokVideoSummary[]; warnings: string[]; } interface tiktokVideoSummary { id: string; caption: string; playCount?: number; coverUrl?: string; playAddr?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/listLikedVideosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.listLikedVideos({ username: "snoopy" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.listLikedVideos({"username": "snoopy"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/listLikedVideos \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"username":"snoopy"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.listLikedVideos({ username: "snoopy" });listNotificationsThe signed-in caller's own activity feed.Arguments
Name Type Required countnumberNo cursornumberNo Returns
{ notifications: Array<{ id?: string; type?: number; createTime?: number; text?: string; fromUser?: { uniqueId?: string; nickname?: string; userId?: string }; videoId?: string }>; hasMore: boolean; cursor?: number }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/listNotificationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.listNotifications({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.listNotifications({}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/listNotifications \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.listNotifications({});listPlaylistVideosThe videos in one playlist, in the creator's order (id, caption, play count, cover, play address).Arguments
Name Type Required playliststringYes limitnumberNo Returns
tiktokVideoSummary[]interface tiktokVideoSummary { id: string; caption: string; playCount?: number; coverUrl?: string; playAddr?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/listPlaylistVideosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.listPlaylistVideos({ playlist: "<playlist>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.listPlaylistVideos({"playlist": "<playlist>"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/listPlaylistVideos \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"playlist":"<playlist>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.listPlaylistVideos({ playlist: "<playlist>" });listSoundVideosThe videos made with one sound, newest or top, paged.Arguments
Name Type Required soundIdstringYes Returns
tiktokVideoSummary[]interface tiktokVideoSummary { id: string; caption: string; playCount?: number; coverUrl?: string; playAddr?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/listSoundVideosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.listSoundVideos({ soundId: "7683649837933497118" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.listSoundVideos({"soundId": "7683649837933497118"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/listSoundVideos \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"soundId":"7683649837933497118"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.listSoundVideos({ soundId: "7683649837933497118" });listTrendingVideosWhat is trending on TikTok right now.Arguments
Name Type Required limitnumberNo Returns
tiktokVideoListinterface tiktokVideoList { videos: tiktokVideoSummary[]; warnings: string[]; } interface tiktokVideoSummary { id: string; caption: string; playCount?: number; coverUrl?: string; playAddr?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/listTrendingVideosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.listTrendingVideos({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.listTrendingVideos({}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/listTrendingVideos \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.listTrendingVideos({});listUserPlaylistsThe playlists a creator shows on their profile (id, name, video count, cover, URL).Arguments
Name Type Required usernamestringNo secUidstringNo limitnumberNo Returns
tiktokPlaylist[]interface tiktokPlaylist { id: string; name: string; videoCount: number; coverUrl?: string; url?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/listUserPlaylistsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.listUserPlaylists({ username: "mrbeast" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.listUserPlaylists({"username": "mrbeast"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/listUserPlaylists \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"username":"mrbeast"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.listUserPlaylists({ username: "mrbeast" });listUserVideosWhat a creator has posted, id, caption, play count, cover and play address for each, the door from a handle to their videos.Arguments
Name Type Required usernamestringYes Returns
tiktokVideoSummary[]interface tiktokVideoSummary { id: string; caption: string; playCount?: number; coverUrl?: string; playAddr?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/listUserVideosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.listUserVideos({ username: "mrbeast" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.listUserVideos({"username": "mrbeast"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/listUserVideos \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"username":"mrbeast"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.listUserVideos({ username: "mrbeast" });searchUsersFind creators matching a name or a topic and get back handle, nickname, bio, avatar, secUid, verified flag, follower, video and like counts.Arguments
Name Type Required querystringYes limitnumber1-10, default 10. Name matches first (0-5), then the top posts' authors on the topic.No Returns
tiktokUserSearchResult[]interface tiktokUserSearchResult { id: string; uniqueId: string; nickname: string; verified: boolean; followerCount: number; videoCount: number; secUid: string; avatar?: string; signature: string; heartCount: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/searchUsersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.searchUsers({ query: "mrbeast" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.searchUsers({"query": "mrbeast"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/searchUsers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"mrbeast"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.searchUsers({ query: "mrbeast" });searchVideosFind TikTok videos on a topic and get back the top posts.Arguments
Name Type Required querystringYes Returns
tiktokSearchResult[]interface tiktokSearchResult { id: string; caption: string; author: { id: string; uniqueId: string; nickname: string; }; stats: { playCount: number; likeCount: number; commentCount: number; shareCount: number; }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/searchVideosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.searchVideos({ query: "iphone" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.searchVideos({"query": "iphone"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/searchVideos \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"iphone"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.searchVideos({ query: "iphone" });
bookmarkVideoSave a video to the signed-in caller's own Favorites/bookmarks.Arguments
Name Type Required videostringYes Returns
{ bookmarked: boolean }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/bookmarkVideoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.bookmarkVideo({ video: "<video>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.bookmarkVideo({"video": "<video>"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/bookmarkVideo \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"video":"<video>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.bookmarkVideo({ video: "<video>" });deleteCommentDelete the caller's own comment.Arguments
Name Type Required videostringYes commentIdstringYes Returns
{ deleted: boolean }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/deleteCommentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.deleteComment({ video: "<video>", commentId: "<commentId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.deleteComment({"video": "<video>", "commentId": "<commentId>"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/deleteComment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"video":"<video>","commentId":"<commentId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.deleteComment({ video: "<video>", commentId: "<commentId>" });deleteVideoDelete a video the signed-in caller uploaded.Arguments
Name Type Required videostringYes Returns
{ deleted: boolean }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/deleteVideoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.deleteVideo({ video: "<video>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.deleteVideo({"video": "<video>"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/deleteVideo \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"video":"<video>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.deleteVideo({ video: "<video>" });editProfileChange the signed-in caller's own display name, bio or bioLink.Arguments
Name Type Required nicknamestringNo signaturestringNo bioLinkstringNo Returns
tiktokOwnProfileinterface tiktokOwnProfile { uniqueId?: string; nickname?: string; signature?: string; emailBound?: boolean; mobileBound?: boolean; privateAccount?: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/editProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.editProfile({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.editProfile({}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/editProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.editProfile({});followUserFollow a creator as the signed-in caller.Arguments
Name Type Required userIdstringYes secUidstringYes Returns
{ followed: boolean }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/followUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.followUser({ userId: "<userId>", secUid: "<secUid>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.followUser({"userId": "<userId>", "secUid": "<secUid>"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/followUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"userId":"<userId>","secUid":"<secUid>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.followUser({ userId: "<userId>", secUid: "<secUid>" });likeVideoLike a video as the signed-in caller.Arguments
Name Type Required videostringYes Returns
{ liked: boolean }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/likeVideoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.likeVideo({ video: "<video>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.likeVideo({"video": "<video>"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/likeVideo \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"video":"<video>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.likeVideo({ video: "<video>" });postCommentPost a comment on a video as the signed-in caller.Arguments
Name Type Required videostringYes textstringYes Returns
{ posted: boolean }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/postCommentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.postComment({ video: "<video>", text: "<text>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.postComment({"video": "<video>", "text": "<text>"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/postComment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"video":"<video>","text":"<text>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.postComment({ video: "<video>", text: "<text>" });sendDirectMessageSend a DM as the signed-in caller to a TikTok account, by handle.Arguments
Name Type Required usernamestringYes textstringYes Returns
{ sent: boolean; username: string }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/sendDirectMessageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.sendDirectMessage({ username: "<username>", text: "<text>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.sendDirectMessage({"username": "<username>", "text": "<text>"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/sendDirectMessage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"username":"<username>","text":"<text>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.sendDirectMessage({ username: "<username>", text: "<text>" });unfollowUserUnfollow a creator, the reverse of followUser.Arguments
Name Type Required userIdstringYes secUidstringYes Returns
{ unfollowed: boolean }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/unfollowUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.unfollowUser({ userId: "<userId>", secUid: "<secUid>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.unfollowUser({"userId": "<userId>", "secUid": "<secUid>"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/unfollowUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"userId":"<userId>","secUid":"<secUid>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.unfollowUser({ userId: "<userId>", secUid: "<secUid>" });unlikeVideoRemove a like the caller placed.Arguments
Name Type Required videostringYes Returns
{ unliked: boolean }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/unlikeVideoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.unlikeVideo({ video: "<video>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.unlikeVideo({"video": "<video>"}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/unlikeVideo \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"video":"<video>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.unlikeVideo({ video: "<video>" });uploadVideoUpload a video to the signed-in caller's own account, with caption, hashtags and privacy setting.Arguments
Name Type Required filestringNo urlstringNo captionstringNo privacy"public" | "friends" | "private"No Returns
{ posted: boolean; privacy: "public" | "friends" | "private" }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/tiktok/uploadVideoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.tiktok.uploadVideo({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.tiktok.uploadVideo({}))curl -X POST https://api.bowmark.ai/v1/sites/tiktok/uploadVideo \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.tiktok.uploadVideo({});
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/tiktok/<function> - OpenAPI
/v1/sites/tiktok/openapi.json