POST Post Shoppable Video
Post Shoppable Video Creator Required scope: creator.video.write Use this API to post the shoppable video. Version 202603
POST/affiliate_creator/202603/videos
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Allowed type: application/json |
| x-tts-access-token Required | string | The creator access_token value from Get Access Token, when user_type = 1. Follow this guide to get creator access_token. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Every single app will have a unique key. Please use the specific key assigned to your app. |
| sign Required | string | Signature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time. |
Body
| Properties | Type | Description |
|---|---|---|
| video_info Required | object | Video information |
| product_link_info Required | object | Product link information |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | The success or failure status code returned in API response. |
| message | string | The success or failure messages returned in API response. Reasons of failure will be described in the message. |
| request_id | string | Request log |
| data | object | Specific return information |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | 16011007 | Product link title should be no longer than 30 characters. | | 16011009 | Product link title contains offensive language. | | 16011069 | Product link title contains punctuation or emoji. | | 38007001 | System Error | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | | 170001002 | Creator TikTok Shop permission check failed. | | 170001003 | Creator Tiktok Shop permission temporarily banned. | | 170001004 | Creator TikTok Shop permission is permanently banned. | | 170001005 | Creator terms of service not signed. Please contact TikTok for more details. | | 170001006 | GKA terms not signed. Please try again after signing GKA term. | | 170001007 | Creator did not sign the EU data share agreement. | | 170001008 | Creator Age verification failed. Please verify age first. | | 170001009 | The product belongs to unsupported category. | | 170001010 | The commission plan gets failed or rejected. | | 170001011 | The product doesn't exist. | | 170001012 | The product is not available. | | 170001013 | Showcase SPU exceeds limit. | | 170001014 | Blocked by spam check. | | 170001015 | Blocked by TikTok Shop risk control. | | 170001018 | Get creator pay account error. Please verify the pay account first. | | 170001020 | You have exceeded the frequency to post EC short videos. Please take a rest. | | 170001024 | cover_timestamp_ms must be a non-negative integer within the video duration. | | 170001025 | cover_timestamp_ms exceeds the video duration. | | 170001030 | Creator account banned. Please contact TikTok agent for your account. | | 170001031 | Creator forbidden to post content. | | 170001040 | Please use valid video file id to post TikTok Shop short video. | | 170001050 | Getting errors during video posting workflow. Please try again or contact TikTok. |
Is this content helpful?Helpful
Not Helpful
PreviousNext