TikTok data for agents: videos, creators, comments, search, transcripts. 25 tools, pay per call.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Replies under one comment. Worth calling only when tiktok_video_comments reported reply_count above 0.
The numeric video id.
comment_id from tiktok_video_comments.
Replies per page. (1-50, default 20)
Offset from the previous response. Omit for page one. (default 0)
false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way.
Replies under one comment. Worth calling only when tiktok_video_comments reported reply_count above 0.
| Argument | Type | Description |
|---|---|---|
| id* | string | The numeric video id. |
| count | integer | Replies per page. (1-50, default 20) |
| cursor | integer | Offset from the previous response. Omit for page one. (default 0) |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
| comment_id* | string | comment_id from tiktok_video_comments. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"comment_id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^\\d{6,25}$",
"minLength": 1,
"description": "The numeric video id."
},
"count": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Replies per page. (1-50, default 20)"
},
"cursor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Offset from the previous response. Omit for page one. (default 0)"
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
},
"comment_id": {
"type": "string",
"pattern": "^\\d{6,25}$",
"minLength": 1,
"description": "comment_id from tiktok_video_comments."
}
}
}A sample of a creator's followers (most recent), plus the total. One page only: TikTok does not page this list reliably, so this is a sample and not an export.
| Argument | Type | Description |
|---|---|---|
| id* | string | sec_uid (MS4w…) or numeric uid. |
| count | integer | Followers to return. (1-50, default 20) |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^(MS4w[A-Za-z0-9_-]{20,}|\\d{6,25})$",
"minLength": 1,
"description": "sec_uid (MS4w…) or numeric uid."
},
"count": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Followers to return. (1-50, default 20)"
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
}
}
}A sample of the accounts a creator follows, plus the total. One page only, for the same reason as followers.
| Argument | Type | Description |
|---|---|---|
| id* | string | sec_uid (MS4w…) or numeric uid. |
| count | integer | Accounts to return. (1-50, default 20) |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^(MS4w[A-Za-z0-9_-]{20,}|\\d{6,25})$",
"minLength": 1,
"description": "sec_uid (MS4w…) or numeric uid."
},
"count": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Accounts to return. (1-50, default 20)"
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
}
}
}Videos a creator has liked. Only works when the account keeps its likes public; most do not, and a private list returns no videos.
| Argument | Type | Description |
|---|---|---|
| id* | string | sec_uid (MS4w…). A numeric uid is not accepted here. |
| count | integer | Videos per page. (1-35, default 20) |
| cursor | integer | max_cursor from the previous page. Omit for page one. (default 0) |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^MS4w[A-Za-z0-9_-]{20,}$",
"minLength": 1,
"description": "sec_uid (MS4w…). A numeric uid is not accepted here."
},
"count": {
"type": "integer",
"maximum": 35,
"minimum": 1,
"description": "Videos per page. (1-35, default 20)"
},
"cursor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "max_cursor from the previous page. Omit for page one. (default 0)"
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
}
}
}A creator's playlists (TikTok calls them mixes or series). Most creators have none, which returns total 0.
| Argument | Type | Description |
|---|---|---|
| id* | string | sec_uid (MS4w…) or numeric uid. |
| cursor | integer | cursor from the previous page. Omit for page one. (default 0) |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^(MS4w[A-Za-z0-9_-]{20,}|\\d{6,25})$",
"minLength": 1,
"description": "sec_uid (MS4w…) or numeric uid."
},
"cursor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "cursor from the previous page. Omit for page one. (default 0)"
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
}
}
}A creator's profile: handle, nickname, bio, follower, following and video counts, privacy and verification flags, and avatar.
| Argument | Type | Description |
|---|---|---|
| id* | string | sec_uid (MS4w…) or numeric uid, from tiktok_resolve_username. |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^(MS4w[A-Za-z0-9_-]{20,}|\\d{6,25})$",
"minLength": 1,
"description": "sec_uid (MS4w…) or numeric uid, from tiktok_resolve_username."
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
}
}
}A creator's posts, newest first, with stats. Page by passing the previous response's max_cursor as cursor until has_more is 0. Pinned posts appear on page one only.
| Argument | Type | Description |
|---|---|---|
| id* | string | sec_uid (MS4w…) or numeric uid. |
| count | integer | Posts per page. (1-35, default 20) |
| cursor | integer | max_cursor from the previous page. Omit for page one. (default 0) |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^(MS4w[A-Za-z0-9_-]{20,}|\\d{6,25})$",
"minLength": 1,
"description": "sec_uid (MS4w…) or numeric uid."
},
"count": {
"type": "integer",
"maximum": 35,
"minimum": 1,
"description": "Posts per page. (1-35, default 20)"
},
"cursor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "max_cursor from the previous page. Omit for page one. (default 0)"
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
}
}
}TikTok's Explore / Discover feed: what is trending now. Not personalised and not cached, so each call returns a fresh set; call again for more.
| Argument | Type | Description |
|---|---|---|
| count | integer | Videos to return. (1-18, default 12) |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"count": {
"type": "integer",
"maximum": 18,
"minimum": 1,
"description": "Videos to return. (1-18, default 12)"
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
}
}
}Hashtag name to its id, with total video and view counts. Feed the id to tiktok_hashtag_videos.
| Argument | Type | Description |
|---|---|---|
| name* | string | The hashtag, with or without #. |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "The hashtag, with or without #."
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
}
}
}Videos under a hashtag. Pages hold about 12 videos whatever count asks for; page with cursor.
| Argument | Type | Description |
|---|---|---|
| id* | string | hashtag id from tiktok_hashtag_resolve. |
| count | integer | Videos per page; TikTok caps this near 12. (1-30, default 20) |
| cursor | integer | cursor from the previous page. Omit for page one. (default 0) |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^\\d{1,25}$",
"minLength": 1,
"description": "hashtag id from tiktok_hashtag_resolve."
},
"count": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "Videos per page; TikTok caps this near 12. (1-30, default 20)"
},
"cursor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "cursor from the previous page. Omit for page one. (default 0)"
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
}
}
}Live rooms matching a keyword, each with playable stream URLs per quality (FLV always, HLS when TikTok provides it), title and viewer count. URLs are signed (see expires_at), but a room usually ends long before its signature does; if one quality fails, try another.
| Argument | Type | Description |
|---|---|---|
| q* | string | Search keywords. |
| count | integer | Rooms to return. (1-30, default 20) |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Search keywords."
},
"count": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "Rooms to return. (1-30, default 20)"
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
}
}
}Search TikTok places (points of interest) by name: address, coordinates, rating, review count and video count.
| Argument | Type | Description |
|---|---|---|
| q* | string | Place name or keywords. |
| count | integer | Places to return. (1-30, default 20) |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Place name or keywords."
},
"count": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "Places to return. (1-30, default 20)"
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
}
}
}Resolve a TikTok @handle to the account's numeric uid and sec_uid. Start here: every tiktok_creator_* tool takes the sec_uid this returns. An empty user_list means no exact match was found.
| Argument | Type | Description |
|---|---|---|
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
| handle* | string | The @handle, with or without the leading @. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"handle"
],
"properties": {
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
},
"handle": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "The @handle, with or without the leading @."
}
}
}Keyword search over accounts, with follower counts. Pages by offset, not cursor. For one exact @handle use tiktok_resolve_username instead: it is cheaper and more reliable.
| Argument | Type | Description |
|---|---|---|
| q* | string | Search keywords. |
| count | integer | Results per page. (1-30, default 10) |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
| offset | integer | Number of results to skip: 0, then count, then 2 x count. (default 0) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Search keywords."
},
"count": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "Results per page. (1-30, default 10)"
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Number of results to skip: 0, then count, then 2 x count. (default 0)"
}
}
}Keyword search over hashtags, with post and view counts. One page only.
| Argument | Type | Description |
|---|---|---|
| q* | string | Search keywords. |
| count | integer | Results to return. (1-30, default 20) |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Search keywords."
},
"count": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "Results to return. (1-30, default 20)"
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
}
}
}Live rooms on air right now that match a keyword, with the host's account. One page only. For playable stream URLs use tiktok_live_streams.
| Argument | Type | Description |
|---|---|---|
| q* | string | Search keywords. |
| count | integer | Rooms to return. (1-30, default 20) |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Search keywords."
},
"count": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "Rooms to return. (1-30, default 20)"
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
}
}
}Keyword search over photo-mode (carousel) posts, with image URLs and stats. One page only.
| Argument | Type | Description |
|---|---|---|
| q* | string | Search keywords. |
| count | integer | Results to return. (1-30, default 20) |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Search keywords."
},
"count": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "Results to return. (1-30, default 20)"
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
}
}
}Keyword search over sounds, with usage counts. cursor is an offset: pass the previous response's cursor.
| Argument | Type | Description |
|---|---|---|
| q* | string | Search keywords. |
| count | integer | Results per page. (1-30, default 20) |
| cursor | integer | cursor from the previous page. Omit for page one. (default 0) |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Search keywords."
},
"count": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "Results per page. (1-30, default 20)"
},
"cursor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "cursor from the previous page. Omit for page one. (default 0)"
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
}
}
}Keyword search over videos. TikTok search is a bounded, re-ranked pool, not an endless list: ask for count 30, page with cursor, dedupe on video_id, and stop when two pages add nothing new.
| Argument | Type | Description |
|---|---|---|
| q* | string | Search keywords. |
| count | integer | Results per page. 30 yields the most distinct results per call. (1-30, default 20) |
| cursor | integer | cursor from the previous page. Omit for page one. (default 0) |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
| sort_type | integer | 0 = relevance (default), 1 = most liked. (0-3) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Search keywords."
},
"count": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "Results per page. 30 yields the most distinct results per call. (1-30, default 20)"
},
"cursor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "cursor from the previous page. Omit for page one. (default 0)"
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
},
"sort_type": {
"type": "integer",
"maximum": 3,
"minimum": 0,
"description": "0 = relevance (default), 1 = most liked. (0-3)"
}
}
}Sound title to music id, with the closest candidates. Feed the id to tiktok_sound_videos.
| Argument | Type | Description |
|---|---|---|
| title* | string | The sound's title as TikTok shows it. |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"title"
],
"properties": {
"title": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "The sound's title as TikTok shows it."
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
}
}
}Videos TikTok associates with a sound. Treat it as a feed seeded by the sound, not a strict filter: some results use a different sound, so check music_id on each row.
| Argument | Type | Description |
|---|---|---|
| id* | string | music id from tiktok_sound_resolve or any video row. |
| cursor | integer | cursor from the previous page. Omit for page one. (default 0) |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^\\d{6,25}$",
"minLength": 1,
"description": "music id from tiktok_sound_resolve or any video row."
},
"cursor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "cursor from the previous page. Omit for page one. (default 0)"
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
}
}
}Top-level comments on a video, with like and reply counts. cursor is an offset: pass the previous response's cursor to continue. TikTok re-ranks between pages, so dedupe on comment_id.
| Argument | Type | Description |
|---|---|---|
| id* | string | The numeric video id. |
| count | integer | Comments per page. (1-50, default 20) |
| cursor | integer | Offset from the previous response. Omit for page one. (default 0) |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^\\d{6,25}$",
"minLength": 1,
"description": "The numeric video id."
},
"count": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Comments per page. (1-50, default 20)"
},
"cursor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Offset from the previous response. Omit for page one. (default 0)"
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
}
}
}Direct media URLs for one post: no-watermark video, watermarked video, audio, covers, and the images of a photo post. Links only, no bytes; they are signed and expire (see expires), so fetch promptly.
| Argument | Type | Description |
|---|---|---|
| id* | string | The numeric video id. |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^\\d{6,25}$",
"minLength": 1,
"description": "The numeric video id."
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
}
}
}One video or photo post by id: caption, plays, likes, comments, shares, saves, duration, hashtags, sound and author.
| Argument | Type | Description |
|---|---|---|
| id* | string | The numeric video id — the digits after /video/ in a TikTok link. |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^\\d{6,25}$",
"minLength": 1,
"description": "The numeric video id — the digits after /video/ in a TikTok link."
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
}
}
}A video's spoken text from TikTok's own caption track: one joined string plus timed cues. has_transcript false means the video has no caption track, which is common and is not an error.
| Argument | Type | Description |
|---|---|---|
| id* | string | The numeric video id. |
| lang | string | Language tag such as en or es-MX. Omit to get the original track. |
| expand | boolean | false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^\\d{6,25}$",
"minLength": 1,
"description": "The numeric video id."
},
"lang": {
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})?$",
"maxLength": 16,
"minLength": 1,
"description": "Language tag such as en or es-MX. Omit to get the original track."
},
"expand": {
"type": "boolean",
"description": "false (default): a compact JSON summary sized for a model's context. true: the complete, unmodified response from the data API — can exceed 500 KB for list tools, so ask for it only when a field you need is missing from the compact form. Same price either way."
}
}
}