Skip to main content
POST
/
tiktok
/
video
/
detail
TikTok Video Detail
curl --request POST \
  --url https://mavi-backend.memories.ai/serve/api/v2/tiktok/video/detail \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "video_id": "7543017294226558221"
}
'
{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "7543017294226558221",
    "title": "Video title",
    "description": "Video description",
    "author": {
      "id": "6638037497953681414",
      "name": "username",
      "nick_name": "Display name"
    },
    "stats": {
      "like_count": 1000,
      "comment_count": 100,
      "share_count": 50,
      "view_count": 10000
    },
    "create_time": 1756245606,
    "video_url": "https://...",
    "cover_url": "https://..."
  },
  "success": true,
  "failed": false
}
This API is used to get detailed information for TikTok videos.
Channel routing guide: see Social Media Scraping Overview. Endpoints with a channel request field let you choose apify, rapid, or memories.ai; endpoints without this field use managed routing.
Each API call costs $0.01 USD.

​
Channel Options

If your request supports a channel option, use it to control how scraper data is sourced:
ChannelWhat it meansTypical trade-off
apifyUses Apify, a dedicated web scraping platform with broad content coverage.Most stable and most complete results, but usually more expensive.
rapidUses RapidAPI, a lower-cost aggregation platform.Lower cost, but less stable and often narrower coverage.
memories.aiManaged routing by Memories.ai.Automatically selects the best price/performance path for your request.
Recommendation: Start with memories.ai unless you need to force a specific provider.

​
Code Example

import requests

BASE_URL = "https://mavi-backend.memories.ai/serve/api/v2"
API_KEY = "sk-mai-this_a_test_string_please_use_your_generated_key_during_testing"
HEADERS = {
    "Authorization": f"{API_KEY}",
    "Content-Type": "application/json"
}

def tiktok_video_detail(video_id: str):
    url = f"{BASE_URL}/tiktok/video/detail"
    data = {"video_id": video_id}
    resp = requests.post(url, json=data, headers=HEADERS)
    return resp.json()

# Usage example
result = tiktok_video_detail("your_tiktok_video_id")
print(result)

​
Request Body

FieldTypeRequiredDescription
video_idstringYesTikTok video ID — the numeric ID at the end of the TikTok video URL
How to get the video_id: Extract the numeric ID from the end of a TikTok video URL.For example, from https://www.tiktok.com/@cutshall73/video/7543017294226558221, the video_id is 7543017294226558221.

​
Response

Returns detailed information for the TikTok video. 
{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "7543017294226558221",
    "title": "Video title",
    "description": "Video description",
    "author": {
      "id": "6638037497953681414",
      "name": "username",
      "nick_name": "Display name"
    },
    "stats": {
      "like_count": 1000,
      "comment_count": 100,
      "share_count": 50,
      "view_count": 10000
    },
    "create_time": 1756245606,
    "video_url": "https://...",
    "cover_url": "https://..."
  },
  "success": true,
  "failed": false
}

​
Response Parameters

ParameterTypeDescription
codestringResponse code, indicates the operation result status
msgstringResponse message, describes the operation result
dataobjectResponse data object, contains video detailed information
data.idstringVideo ID
data.titlestringVideo title
data.descriptionstringVideo description
data.authorobjectAuthor information
data.author.idstringAuthor ID
data.author.namestringAuthor username
data.author.nick_namestringAuthor display name
data.statsobjectStatistics data
data.stats.like_countnumberLike count
data.stats.comment_countnumberComment count
data.stats.share_countnumberShare count
data.stats.view_countnumberView count
data.create_timenumberCreation timestamp
data.video_urlstringVideo URL
data.cover_urlstringCover image URL
successbooleanIndicates whether the operation was successful
failedbooleanIndicates whether the operation failed

Authorizations

​
Authorization
string
header
required

Body

application/json
​
video_id
string
required

TikTok video ID

Example:

"7543017294226558221"

Response

200 - application/json

Successfully returned video detailed information

​
code
string

Response code, indicates the operation result status

Example:

200

​
msg
string

Response message, describes the operation result

Example:

"success"

​
data
object

Response data object, contains video detailed information

​
success
boolean

Indicates whether the operation was successful

Example:

true

​
failed
boolean

Indicates whether the operation failed

Example:

false