Upload Product File

POST

/product/202309/files/upload

Upload non-image files, such as PDF or video to TikTok Shop. Use this API when you need to add videos to your product to improve the shopping experience, or submit certifications or reports to meet TikTok Shop requirements for listing restricted products. Note: Retain the file ID from the response and pass it when creating or editing a product to associate the file with the product.

Authorizations

• accessToken

Request Body^required

Media typemultipart/form-data

object

data

required

The local file to be uploaded.

Note:

• Supported formats: PDF, MP4, MOV, MKV, WMV, WEBM, AVI, 3GP, FLV, MPEG
• Zero-byte files are rejected.
• Max PDF size: 20 MB
• Max video size: 100 MB
• Video aspect ratio: 9:16 to 16:9

Recommendations for product videos:

• Aspect ratio: 1:1
• Resolution: HD 720p or higher
• Duration: 20 - 60 seconds

string format: binary

name

required

The name of the file, including the file extension (e.g. certification.pdf)

Note:

• Do not use additional periods, except the one preceding the file extension.
• Do not begin the name with symbols.
• Do not include spaces.

string

Responses

200

Success

Media typeapplication/json

object

code

Status code; 0 means success.

integer format: int64

message

Success or failure message.

string

request_id

Request log ID.

string

data

object

id

The file ID generated by TikTok Shop. Pass this value when creating or editing a product to associate the file with the product.

string

url

The URL to access and view the file.

string

name

The name of the file.

string

format

The format of the file. Possible values: PDF, MP4, MOV, MKV, WMV, WEBM, AVI, 3GP, FLV, MPEG

string

Allowed values: PDF MP4 MOV MKV WMV WEBM AVI 3GP FLV MPEG

Example

{
  "code": 0,
  "data": {
    "id": "v09e40f40000cfu0ovhc77ub7fl97k4w",
    "url": "https://p-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/c668cdf70b7f483c94dbe\n",
    "name": "SNI.PDF",
    "format": "PDF"
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}