Tabcut Open API
  1. Item Video
Tabcut Open API
  • 【Must-Read】About Signature
  • Data APIs
    • Item
      • Item Ranking
      • Item Search
      • Item Basic
      • Item Video List
      • Item Creator List
      • Item Trend
      • Item Sales Mode Distribution
      • Item Sales Channels Distribution
    • Item Creator
      • Item Creator Statistic
      • Item Creator Basic
      • Item Creator Items
      • Item Creator Item Category
      • Item Creator Video Trend
      • Item Creator Video Category
      • Item Creator Video List
      • Item Creator Video Detail
      • Item Creator Search
      • Item Creator Trend
    • Seller
      • Seller Ranking
      • Seller Search
    • Item Video
      • Item Video Item List
        GET
      • Item Video Trend
        GET
      • Item Video Basic
        GET
      • Item Video Play Url
        GET
  • Meta APIs
    • Translation of Item category names
    • Region List
      GET
    • Item Category List
      GET
    • Tiktok Category List
      GET
  1. Item Video

Item Video Play Url

GET
/api/item_video/play_url

Notes#

1.
Returns Tabcut's video play URL and video cover URL.
2.
If Tabcut has not downloaded the video, Tabcut will attempt to download it and return status code "10025". Normally, make the request again after a few minutes to get the video link.
3.
The waiting time cannot be guaranteed and is related to the number of tasks. Usually, waiting for 3 to 5 minutes is sufficient.

Response Codes#

"200": Returns the download link.
"10025": The download task is in progress. Please try again later.
"10026": The download task failed. The source file does not exist on TikTok. The author may have deleted the video.
"5000": Internal server error. Please contact customer service.

Request

Query Params
videoId
string 
required
Video ID
Header Params
x-appKey
string 
required
Please replace with real parameters when calling the API.
Example:
{{appKey}}
x-timestamp
string 
required
Please replace with real parameters when calling the API.
Example:
{{x-timestamp}}
x-sign
string 
required
Please replace with real parameters when calling the API.
Example:
{{x-sign}}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://open.tabcut.com:8090/api/item_video/play_url?videoId' \
--header 'x-appKey: ' \
--header 'x-timestamp: {{x-timestamp}}' \
--header 'x-sign: {{x-sign}}'

Responses

🟢200Success
application/json
Body
code
string 
required
message
string 
required
result
object 
required
videoId
string 
required
Video ID
coverUrl
string 
required
Tabcut's video cover URL
playUrl
string 
required
Tabcut's video play URL
serverTime
string 
required
Example
{
    "code": "string",
    "message": "string",
    "result": {
        "videoId": "string",
        "coverUrl": "string",
        "playUrl": "string"
    },
    "serverTime": "string"
}
Modified at 2025-06-24 12:32:51
Previous
Item Video Basic
Next
Translation of Item category names
Built with