TikTok

TikTok data for agents: user profiles, followers and following, videos and reposts, search, comments and replies, music tracks, for you feeds, video and audio downloads.

GET/v1/tiktok/user-info

https://api.vee3.io/v1/tiktok/user-info

2 tokens

Look up a TikTok user profile by user id or unique id.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

tiktok.user_info

Parameters2 fields

user_idstringOptional

TikTok numeric user id.

max length 128

unique_idstringOptional

TikTok unique id (username).

max length 128

Response7 fields

codeinteger

Upstream status code (0 = success).

msgstring

Upstream status message.

processed_timenumber

Upstream processing time in seconds.

dataobject

3 fields

Capability-specific payload from the upstream provider.

cursorstring

Pagination cursor when returned by the provider.

hasMoreboolean

Whether additional pages are available.

totalinteger

Total result count when provided by the upstream provider.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, tiktok_not_configured, tiktok_upstream_error, tiktok_download_empty

Example request

Python

import requests

url = "https://api.vee3.io/v1/tiktok/user-info"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "unique_id": "mrbeast"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Public profile summary for MrBeast.

mrbeast_profile.json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.8421,
  "data": {
    "user": {
      "id": "6614519312189947909",
      "uniqueId": "mrbeast",
      "nickname": "MrBeast",
      "signature": "SUBSCRIBE FOR A COOKIE!",
      "verified": true,
      "follower_count": 94377978,
      "following_count": 321
    }
  }
}

GET/v1/tiktok/user-videos

https://api.vee3.io/v1/tiktok/user-videos

3 tokens

List videos posted by a TikTok user.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

tiktok.user_videos

Parameters5 fields

user_idstringOptional

TikTok numeric user id.

max length 128

unique_idstringOptional

TikTok unique id (username).

max length 128

countintegerRequired

Number of items to return (max 30).

Default: 10 · min 1, max 30

cursorstringOptional

Pagination cursor from a previous response.

max length 4096

latestbooleanRequired

When true, return latest videos. When false, return top videos.

Default: true

Response7 fields

codeinteger

Upstream status code (0 = success).

msgstring

Upstream status message.

processed_timenumber

Upstream processing time in seconds.

dataobject

3 fields

Capability-specific payload from the upstream provider.

cursorstring

Pagination cursor when returned by the provider.

hasMoreboolean

Whether additional pages are available.

totalinteger

Total result count when provided by the upstream provider.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, tiktok_not_configured, tiktok_upstream_error, tiktok_download_empty

Example request

Python

import requests

url = "https://api.vee3.io/v1/tiktok/user-videos"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "unique_id": "mrbeast",
    "count": 10,
    "latest": True
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Paginated list of videos for a user.

user_videos_page.json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.5123,
  "data": {
    "videos": [
      {
        "id": "7516594811734854943",
        "title": "make your money count",
        "author": {
          "id": "107955",
          "uniqueId": "tiktok",
          "nickname": "TikTok"
        },
        "play_count": 1240000,
        "digg_count": 98000
      }
    ],
    "cursor": "1781282535",
    "hasMore": true
  }
}

GET/v1/tiktok/user-reposts

https://api.vee3.io/v1/tiktok/user-reposts

3 tokens

List reposts for a TikTok user.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

tiktok.user_reposts

Parameters4 fields

user_idstringOptional

TikTok numeric user id.

max length 128

unique_idstringOptional

TikTok unique id (username).

max length 128

countintegerRequired

Number of items to return (max 30).

Default: 10 · min 1, max 30

cursorstringOptional

Pagination cursor from a previous response.

max length 4096

Response7 fields

codeinteger

Upstream status code (0 = success).

msgstring

Upstream status message.

processed_timenumber

Upstream processing time in seconds.

dataobject

3 fields

Capability-specific payload from the upstream provider.

cursorstring

Pagination cursor when returned by the provider.

hasMoreboolean

Whether additional pages are available.

totalinteger

Total result count when provided by the upstream provider.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, tiktok_not_configured, tiktok_upstream_error, tiktok_download_empty

Example request

Python

import requests

url = "https://api.vee3.io/v1/tiktok/user-reposts"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "unique_id": "mrbeast",
    "count": 10
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Paginated list of reposted videos.

user_reposts_page.json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.4318,
  "data": {
    "videos": [
      {
        "id": "7516594811734854943",
        "title": "make your money count",
        "author": {
          "id": "107955",
          "uniqueId": "tiktok",
          "nickname": "TikTok"
        },
        "play_count": 1240000,
        "digg_count": 98000
      }
    ],
    "cursor": "1781282535",
    "hasMore": false
  }
}

GET/v1/tiktok/user-followers

https://api.vee3.io/v1/tiktok/user-followers

2 tokens

List followers for a TikTok user.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

tiktok.user_followers

Parameters3 fields

user_idstringRequired

TikTok numeric user id.

max length 128

countintegerRequired

Number of items to return (max 200).

Default: 100 · min 1, max 200

cursorstringOptional

Pagination cursor from a previous response.

max length 4096

Response7 fields

codeinteger

Upstream status code (0 = success).

msgstring

Upstream status message.

processed_timenumber

Upstream processing time in seconds.

dataobject

3 fields

Capability-specific payload from the upstream provider.

cursorstring

Pagination cursor when returned by the provider.

hasMoreboolean

Whether additional pages are available.

totalinteger

Total result count when provided by the upstream provider.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, tiktok_not_configured, tiktok_upstream_error, tiktok_download_empty

Example request

Python

import requests

url = "https://api.vee3.io/v1/tiktok/user-followers"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "user_id": "6614519312189947909",
    "count": 10
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Paginated follower list with cursor.

followers_page.json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.2214,
  "data": {
    "followers": [
      {
        "id": "6614519312189947909",
        "uniqueId": "mrbeast",
        "nickname": "MrBeast",
        "follower_count": 94377978,
        "following_count": 321
      }
    ],
    "total": 94377978,
    "cursor": "1781282535",
    "hasMore": true
  }
}

GET/v1/tiktok/user-following

https://api.vee3.io/v1/tiktok/user-following

2 tokens

List accounts a TikTok user follows.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

tiktok.user_following

Parameters3 fields

user_idstringRequired

TikTok numeric user id.

max length 128

countintegerRequired

Number of items to return (max 200).

Default: 100 · min 1, max 200

cursorstringOptional

Pagination cursor from a previous response.

max length 4096

Response7 fields

codeinteger

Upstream status code (0 = success).

msgstring

Upstream status message.

processed_timenumber

Upstream processing time in seconds.

dataobject

3 fields

Capability-specific payload from the upstream provider.

cursorstring

Pagination cursor when returned by the provider.

hasMoreboolean

Whether additional pages are available.

totalinteger

Total result count when provided by the upstream provider.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, tiktok_not_configured, tiktok_upstream_error, tiktok_download_empty

Example request

Python

import requests

url = "https://api.vee3.io/v1/tiktok/user-following"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "user_id": "6614519312189947909",
    "count": 10
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses2 examples

200Paginated following list with cursor.

following_page.json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.1982,
  "data": {
    "following": [
      {
        "id": "6614519312189947909",
        "uniqueId": "mrbeast",
        "nickname": "MrBeast",
        "follower_count": 94377978,
        "following_count": 321
      }
    ],
    "total": 321,
    "cursor": "1781282535",
    "hasMore": false
  }
}

200Returned when the user hides their following list.

private_following_list.json

{
  "code": -1,
  "msg": "Profile user is hiding following list.",
  "processed_time": 0.6742
}

GET/v1/tiktok/video-details

https://api.vee3.io/v1/tiktok/video-details

1 tokens

Look up metadata for a TikTok video by id or URL.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

tiktok.video_details

Parameters2 fields

video_idstringOptional

TikTok video id.

max length 32

video_urlstringOptional

TikTok video URL.

max length 2048

Response7 fields

codeinteger

Upstream status code (0 = success).

msgstring

Upstream status message.

processed_timenumber

Upstream processing time in seconds.

dataobject

3 fields

Capability-specific payload from the upstream provider.

cursorstring

Pagination cursor when returned by the provider.

hasMoreboolean

Whether additional pages are available.

totalinteger

Total result count when provided by the upstream provider.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, tiktok_not_configured, tiktok_upstream_error, tiktok_download_empty

Example request

Python

import requests

url = "https://api.vee3.io/v1/tiktok/video-details"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "video_id": "7516594811734854943"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Video metadata including play URLs and music info.

video_metadata.json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.2779,
  "data": {
    "id": "7516594811734854943",
    "title": "make your money count",
    "play": "https://v16-webapp-prime.tiktok.com/video/example-play.mp4",
    "hdplay": "https://v16-webapp-prime.tiktok.com/video/example-hdplay.mp4",
    "author": {
      "uniqueId": "tiktok",
      "nickname": "TikTok"
    },
    "music_info": {
      "id": "6974398592418809857",
      "title": "Bad Habits",
      "play": "https://v16-webapp-prime.tiktok.com/music/example.mp3"
    }
  }
}

GET/v1/tiktok/video/comments

https://api.vee3.io/v1/tiktok/video/comments

2 tokens

List comments on a TikTok video.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

tiktok.video_comments

Parameters4 fields

video_idstringOptional

TikTok video id.

max length 32

video_urlstringOptional

TikTok video URL.

max length 2048

countintegerRequired

Number of comments to return (max 50).

Default: 10 · min 1, max 50

cursorstringOptional

Pagination cursor from a previous response.

max length 4096

Response7 fields

codeinteger

Upstream status code (0 = success).

msgstring

Upstream status message.

processed_timenumber

Upstream processing time in seconds.

dataobject

3 fields

Capability-specific payload from the upstream provider.

cursorstring

Pagination cursor when returned by the provider.

hasMoreboolean

Whether additional pages are available.

totalinteger

Total result count when provided by the upstream provider.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, tiktok_not_configured, tiktok_upstream_error, tiktok_download_empty

Example request

Python

import requests

url = "https://api.vee3.io/v1/tiktok/video/comments"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "video_id": "7516594811734854943",
    "count": 10
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Paginated comments with total count.

comments_page.json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.3891,
  "data": {
    "comments": [
      {
        "id": "7233490004960510747",
        "text": "This is amazing!",
        "digg_count": 142,
        "user": {
          "uniqueId": "fan_account",
          "nickname": "Fan Account"
        }
      }
    ],
    "cursor": "1781282535",
    "hasMore": true,
    "total": 8421
  }
}

GET/v1/tiktok/comment/replies

https://api.vee3.io/v1/tiktok/comment/replies

2 tokens

List replies to a TikTok comment.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

tiktok.comment_replies

Parameters4 fields

video_idstringRequired

TikTok video id.

max length 32

comment_idstringRequired

TikTok comment id.

max length 32

countintegerRequired

Number of replies to return (max 40).

Default: 10 · min 1, max 40

cursorstringOptional

Pagination cursor from a previous response.

max length 4096

Response7 fields

codeinteger

Upstream status code (0 = success).

msgstring

Upstream status message.

processed_timenumber

Upstream processing time in seconds.

dataobject

3 fields

Capability-specific payload from the upstream provider.

cursorstring

Pagination cursor when returned by the provider.

hasMoreboolean

Whether additional pages are available.

totalinteger

Total result count when provided by the upstream provider.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, tiktok_not_configured, tiktok_upstream_error, tiktok_download_empty

Example request

Python

import requests

url = "https://api.vee3.io/v1/tiktok/comment/replies"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "video_id": "7516594811734854943",
    "comment_id": "7233490004960510747",
    "count": 10
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Paginated replies for a parent comment.

replies_page.json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.2944,
  "data": {
    "comments": [
      {
        "id": "7233490004960510748",
        "text": "Totally agree!",
        "digg_count": 12,
        "user": {
          "uniqueId": "reply_user",
          "nickname": "Reply User"
        }
      }
    ],
    "cursor": "1781282535",
    "hasMore": false
  }
}

GET/v1/tiktok/search/videos

https://api.vee3.io/v1/tiktok/search/videos

5 tokens

Search TikTok videos by keyword.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

tiktok.search_videos

Parameters6 fields

querystringRequired

Search keywords.

max length 512

regionstringOptional

Region code (for example us, jp, kr).

max length 8

countintegerRequired

Number of items to return (max 30).

Default: 10 · min 1, max 30

cursorstringOptional

Pagination cursor from a previous response.

max length 4096

publish_timeintegerOptional

Publish time filter: 0, 1, 7, 30, 90, or 180.

sort_bystringRequired

Sort order: relevance, like_count, or date_posted.

Default: "relevance"

Response7 fields

codeinteger

Upstream status code (0 = success).

msgstring

Upstream status message.

processed_timenumber

Upstream processing time in seconds.

dataobject

3 fields

Capability-specific payload from the upstream provider.

cursorstring

Pagination cursor when returned by the provider.

hasMoreboolean

Whether additional pages are available.

totalinteger

Total result count when provided by the upstream provider.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, tiktok_not_configured, tiktok_upstream_error, tiktok_download_empty

Example request

Python

import requests

url = "https://api.vee3.io/v1/tiktok/search/videos"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "query": "cooking",
    "region": "us",
    "sort_by": "like_count"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Matching videos with pagination cursor.

video_search_results.json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.847,
  "data": {
    "videos": [
      {
        "id": "7516594811734854943",
        "title": "make your money count",
        "author": {
          "id": "107955",
          "uniqueId": "tiktok",
          "nickname": "TikTok"
        },
        "play_count": 1240000,
        "digg_count": 98000
      }
    ],
    "cursor": "1781282535",
    "hasMore": true
  }
}

GET/v1/tiktok/search/users

https://api.vee3.io/v1/tiktok/search/users

5 tokens

Search TikTok users by keyword.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

tiktok.search_users

Parameters4 fields

querystringRequired

Search keywords.

max length 512

countintegerRequired

Number of items to return (max 30).

Default: 10 · min 1, max 30

cursorstringOptional

Pagination cursor from a previous response.

max length 4096

follower_countstringRequired

Follower count filter: 0-4.

Default: "0"

Response7 fields

codeinteger

Upstream status code (0 = success).

msgstring

Upstream status message.

processed_timenumber

Upstream processing time in seconds.

dataobject

3 fields

Capability-specific payload from the upstream provider.

cursorstring

Pagination cursor when returned by the provider.

hasMoreboolean

Whether additional pages are available.

totalinteger

Total result count when provided by the upstream provider.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, tiktok_not_configured, tiktok_upstream_error, tiktok_download_empty

Example request

Python

import requests

url = "https://api.vee3.io/v1/tiktok/search/users"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "query": "mrbeast",
    "count": 10
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Matching user profiles with pagination cursor.

user_search_results.json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.6214,
  "data": {
    "users": [
      {
        "id": "6614519312189947909",
        "uniqueId": "mrbeast",
        "nickname": "MrBeast",
        "follower_count": 94377978,
        "following_count": 321
      }
    ],
    "cursor": "1781282535",
    "hasMore": true
  }
}

GET/v1/tiktok/search/photos

https://api.vee3.io/v1/tiktok/search/photos

5 tokens

Search TikTok photo posts by keyword.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

tiktok.search_photos

Parameters4 fields

querystringRequired

Search keywords.

max length 512

regionstringOptional

Region code (for example us, jp, kr).

max length 8

countintegerRequired

Number of items to return (max 30).

Default: 10 · min 1, max 30

cursorstringOptional

Pagination cursor from a previous response.

max length 4096

Response7 fields

codeinteger

Upstream status code (0 = success).

msgstring

Upstream status message.

processed_timenumber

Upstream processing time in seconds.

dataobject

3 fields

Capability-specific payload from the upstream provider.

cursorstring

Pagination cursor when returned by the provider.

hasMoreboolean

Whether additional pages are available.

totalinteger

Total result count when provided by the upstream provider.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, tiktok_not_configured, tiktok_upstream_error, tiktok_download_empty

Example request

Python

import requests

url = "https://api.vee3.io/v1/tiktok/search/photos"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "query": "travel",
    "region": "us",
    "count": 10
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Matching photo posts with pagination cursor.

photo_search_results.json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.5531,
  "data": {
    "photos": [
      {
        "id": "7516594811734854944",
        "title": "weekend recap",
        "author": {
          "uniqueId": "tiktok",
          "nickname": "TikTok"
        }
      }
    ],
    "cursor": "1781282535",
    "hasMore": true
  }
}

GET/v1/tiktok/feed/for-you

https://api.vee3.io/v1/tiktok/feed/for-you

4 tokens

Fetch TikTok for you page videos for a region.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

tiktok.for_you_feed

Parameters2 fields

regionstringRequired

Region code (for example us, jp, kr).

max length 8

countintegerRequired

Number of videos to return (max 20).

Default: 10 · min 1, max 20

Response6 fields

codeinteger

Upstream status code (0 = success).

msgstring

Upstream status message.

processed_timenumber

Upstream processing time in seconds.

dataarrayitems

2 fields

For-you feed videos from the upstream provider.

video_idstring

TikTok video id.

titlestring

Video title or caption.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, tiktok_not_configured, tiktok_upstream_error, tiktok_download_empty

Example request

Python

import requests

url = "https://api.vee3.io/v1/tiktok/feed/for-you"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "region": "us",
    "count": 10
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Regional for-you feed video list.

for_you_videos.json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.7128,
  "data": [
    {
      "video_id": "7516594811734854943",
      "title": "make your money count",
      "author": {
        "unique_id": "tiktok",
        "nickname": "TikTok"
      },
      "play_count": 1240000,
      "digg_count": 98000
    }
  ]
}

GET/v1/tiktok/music/details

https://api.vee3.io/v1/tiktok/music/details

2 tokens

Look up metadata for a TikTok music track.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

tiktok.music_details

Parameters2 fields

music_idstringOptional

TikTok music id.

max length 64

music_urlstringOptional

TikTok music page URL.

max length 2048

Response7 fields

codeinteger

Upstream status code (0 = success).

msgstring

Upstream status message.

processed_timenumber

Upstream processing time in seconds.

dataobject

3 fields

Capability-specific payload from the upstream provider.

cursorstring

Pagination cursor when returned by the provider.

hasMoreboolean

Whether additional pages are available.

totalinteger

Total result count when provided by the upstream provider.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, tiktok_not_configured, tiktok_upstream_error, tiktok_download_empty

Example request

Python

import requests

url = "https://api.vee3.io/v1/tiktok/music/details"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "music_id": "6974398592418809857"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Music track metadata including play URL.

music_metadata.json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.8036,
  "data": {
    "id": "6974398592418809857",
    "title": "Bad Habits",
    "author": "Ed Sheeran",
    "play": "https://v16-webapp-prime.tiktok.com/music/example-track.mp3",
    "duration": 30
  }
}

GET/v1/tiktok/music/videos

https://api.vee3.io/v1/tiktok/music/videos

3 tokens

List videos that use a TikTok music track.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

tiktok.music_videos

Parameters3 fields

music_idstringRequired

TikTok music id.

max length 64

countintegerRequired

Number of items to return (max 30).

Default: 10 · min 1, max 30

cursorstringOptional

Pagination cursor from a previous response.

max length 4096

Response7 fields

codeinteger

Upstream status code (0 = success).

msgstring

Upstream status message.

processed_timenumber

Upstream processing time in seconds.

dataobject

3 fields

Capability-specific payload from the upstream provider.

cursorstring

Pagination cursor when returned by the provider.

hasMoreboolean

Whether additional pages are available.

totalinteger

Total result count when provided by the upstream provider.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, tiktok_not_configured, tiktok_upstream_error, tiktok_download_empty

Example request

Python

import requests

url = "https://api.vee3.io/v1/tiktok/music/videos"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "music_id": "6974398592418809857",
    "count": 10
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Paginated videos using the requested music track.

music_videos_page.json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.4672,
  "data": {
    "videos": [
      {
        "id": "7516594811734854943",
        "title": "make your money count",
        "author": {
          "id": "107955",
          "uniqueId": "tiktok",
          "nickname": "TikTok"
        },
        "play_count": 1240000,
        "digg_count": 98000
      }
    ],
    "cursor": "1781282535",
    "hasMore": true
  }
}

GET/v1/tiktok/video/download

https://api.vee3.io/v1/tiktok/video/download

10 tokens

Download a TikTok video to account file storage with a signed URL and download code.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

tiktok.download_video

Parameters4 fields

video_idstringOptional

TikTok video id.

max length 32

video_urlstringOptional

TikTok video URL.

max length 2048

quality"standard" | "hd"Optional

Video quality to download. 'standard' is default quality; 'hd' is high definition. Only one selected quality is downloaded.

Default: "standard"

file_namestringOptional

Optional account-relative storage path for the video. If omitted, the file is stored under downloads/ with a generated name.

max length 255

Response13 fields

tiktok_download_idstring

Unique TikTok download operation identifier, prefix td_.

file_urlstring

Signed download URL from account file storage.

file_namestring

Account-relative path where the file was stored.

file_size_bytesinteger

Downloaded file size in bytes.

content_typestring

MIME type of the downloaded file.

retained_untilstring

ISO 8601 timestamp when account storage retention expires.

download_codestring

Short code to pass to the @vee3/cli `vee3-get-file` command.

download_idstring

Stable identifier for the reserved agent download session.

expires_atstring

ISO 8601 timestamp when the download code can no longer be resolved (60 minutes after reserve).

install_commandstring

One-time command to install the Vee3 CLI (`npm install -g @vee3/cli`). On networks that inspect HTTPS, install may require Node 22.15+ with NODE_OPTIONS=--use-system-ca.

commandstring

Suggested terminal command for downloading to a local path.

troubleshootingstring

What to do if installation or downloading fails: re-read this tool's description via meta-tools.describe for setup and troubleshooting steps.

qualityenum

Echo of the requested video quality (standard or hd).

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, tiktok_not_configured, tiktok_upstream_error, tiktok_download_empty, tiktok_hd_unavailable, uploaded_file_name_in_use, internal_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/tiktok/video/download"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "video_id": "7516594811734854943"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses2 examples

200Standard-quality video saved to account file storage.

stored_standard_video.json

{
  "tiktok_download_id": "td_example01abcdef12",
  "file_url": "https://f000.backblazeb2.com/file/vee3-user-uploads/acct/downloads/td_example01abcdef12_standard.mp4?Authorization=...",
  "file_name": "downloads/td_example01abcdef12_standard.mp4",
  "file_size_bytes": 7786703,
  "content_type": "video/mp4",
  "retained_until": "2026-05-28T12:00:00Z",
  "quality": "standard",
  "download_code": "bK3mP9x2",
  "download_id": "4feacf05-aae6-5e9a-97c4-9edfcd756306",
  "expires_at": "2026-05-26T13:00:00Z",
  "install_command": "npm install -g @vee3/cli",
  "command": "vee3-get-file bK3mP9x2 ./path/to/save",
  "troubleshooting": "If installation or downloading fails, call meta-tools.describe with tool_name 'files.download_file' and follow its setup and troubleshooting notes."
}

200High-definition video saved to account file storage.

stored_hd_video.json

{
  "tiktok_download_id": "td_example01abcdef12",
  "file_url": "https://f000.backblazeb2.com/file/vee3-user-uploads/acct/downloads/td_example01abcdef12_hd.mp4?Authorization=...",
  "file_name": "downloads/td_example01abcdef12_hd.mp4",
  "file_size_bytes": 38711004,
  "content_type": "video/mp4",
  "retained_until": "2026-05-28T12:00:00Z",
  "quality": "hd",
  "download_code": "bK3mP9x2",
  "download_id": "4feacf05-aae6-5e9a-97c4-9edfcd756306",
  "expires_at": "2026-05-26T13:00:00Z",
  "install_command": "npm install -g @vee3/cli",
  "command": "vee3-get-file bK3mP9x2 ./path/to/save",
  "troubleshooting": "If installation or downloading fails, call meta-tools.describe with tool_name 'files.download_file' and follow its setup and troubleshooting notes."
}

GET/v1/tiktok/music/download-from-video

https://api.vee3.io/v1/tiktok/music/download-from-video

10 tokens

Download music from a TikTok video to account file storage with a signed URL and download code.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

tiktok.download_music_from_video

Parameters3 fields

video_idstringOptional

TikTok video id.

max length 32

video_urlstringOptional

TikTok video URL.

max length 2048

file_namestringOptional

Optional account-relative storage path for the music file. If omitted, the file is stored under downloads/ with a generated name.

max length 255

Response12 fields

tiktok_download_idstring

Unique TikTok download operation identifier, prefix td_.

file_urlstring

Signed download URL from account file storage.

file_namestring

Account-relative path where the file was stored.

file_size_bytesinteger

Music file size in bytes.

content_typestring

MIME type of the music file.

retained_untilstring

ISO 8601 timestamp when account storage retention expires.

download_codestring

Short code to pass to the @vee3/cli `vee3-get-file` command.

download_idstring

Stable identifier for the reserved agent download session.

expires_atstring

ISO 8601 timestamp when the download code can no longer be resolved (60 minutes after reserve).

install_commandstring

One-time command to install the Vee3 CLI (`npm install -g @vee3/cli`). On networks that inspect HTTPS, install may require Node 22.15+ with NODE_OPTIONS=--use-system-ca.

commandstring

Suggested terminal command for downloading to a local path.

troubleshootingstring

What to do if installation or downloading fails: re-read this tool's description via meta-tools.describe for setup and troubleshooting steps.

Example request

Python

import requests

url = "https://api.vee3.io/v1/tiktok/music/download-from-video"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "video_id": "7516594811734854943"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Music extracted from a video and saved to account file storage with signed URL and download code.

stored_music_from_video.json

{
  "tiktok_download_id": "td_example01abcdef12",
  "file_url": "https://f000.backblazeb2.com/file/vee3-user-uploads/acct/downloads/td_example01abcdef12_music_from_video.mp3?Authorization=...",
  "file_name": "downloads/td_example01abcdef12_music_from_video.mp3",
  "file_size_bytes": 524288,
  "content_type": "audio/mpeg",
  "retained_until": "2026-05-28T12:00:00Z",
  "download_code": "bK3mP9x2",
  "download_id": "4feacf05-aae6-5e9a-97c4-9edfcd756306",
  "expires_at": "2026-05-26T13:00:00Z",
  "install_command": "npm install -g @vee3/cli",
  "command": "vee3-get-file bK3mP9x2 ./path/to/save",
  "troubleshooting": "If installation or downloading fails, call meta-tools.describe with tool_name 'files.download_file' and follow its setup and troubleshooting notes."
}

GET/v1/tiktok/music/download

https://api.vee3.io/v1/tiktok/music/download

10 tokens

Download a TikTok music track to account file storage with a signed URL and download code.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

tiktok.download_music

Parameters3 fields

music_idstringOptional

TikTok music id.

max length 64

music_urlstringOptional

TikTok music page URL.

max length 2048

file_namestringOptional

Optional account-relative storage path for the music file. If omitted, the file is stored under downloads/ with a generated name.

max length 255

Response12 fields

tiktok_download_idstring

Unique TikTok download operation identifier, prefix td_.

file_urlstring

Signed download URL from account file storage.

file_namestring

Account-relative path where the file was stored.

file_size_bytesinteger

Music file size in bytes.

content_typestring

MIME type of the music file.

retained_untilstring

ISO 8601 timestamp when account storage retention expires.

download_codestring

Short code to pass to the @vee3/cli `vee3-get-file` command.

download_idstring

Stable identifier for the reserved agent download session.

expires_atstring

ISO 8601 timestamp when the download code can no longer be resolved (60 minutes after reserve).

install_commandstring

One-time command to install the Vee3 CLI (`npm install -g @vee3/cli`). On networks that inspect HTTPS, install may require Node 22.15+ with NODE_OPTIONS=--use-system-ca.

commandstring

Suggested terminal command for downloading to a local path.

troubleshootingstring

What to do if installation or downloading fails: re-read this tool's description via meta-tools.describe for setup and troubleshooting steps.

Example request

Python

import requests

url = "https://api.vee3.io/v1/tiktok/music/download"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "music_id": "6974398592418809857"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Music file saved to account file storage with signed URL and download code.

stored_music_file.json

{
  "tiktok_download_id": "td_example01abcdef12",
  "file_url": "https://f000.backblazeb2.com/file/vee3-user-uploads/acct/downloads/td_example01abcdef12_music.mp3?Authorization=...",
  "file_name": "downloads/td_example01abcdef12_music.mp3",
  "file_size_bytes": 524288,
  "content_type": "audio/mpeg",
  "retained_until": "2026-05-28T12:00:00Z",
  "download_code": "bK3mP9x2",
  "download_id": "4feacf05-aae6-5e9a-97c4-9edfcd756306",
  "expires_at": "2026-05-26T13:00:00Z",
  "install_command": "npm install -g @vee3/cli",
  "command": "vee3-get-file bK3mP9x2 ./path/to/save",
  "troubleshooting": "If installation or downloading fails, call meta-tools.describe with tool_name 'files.download_file' and follow its setup and troubleshooting notes."
}