Create shop-level customized TikTok posts
POST/gmv_max/creation/custom_anchor_video_list/create/Via 360: POST https://partner.quantri360.com/v1/tiktok_business/gmv_max/creation/custom_anchor_video_list/create/
Write endpoint — changes data on TikTok Business. The key must be created with "Allow write API calls" ticked, otherwise you get 403 write_not_allowed. Every call is logged.
Description
Use this endpoint to create shop-level customized TikTok posts.
Shop-level customized TikTok posts are generated by directly linking your TikTok videos to a product at the TikTok Shop level. If the linked product is part of an active campaign, the video linked to that product will be automatically added to that campaign.
Request
Endpoint
POST https://partner.quantri360.com/v1/tiktok_business/gmv_max/creation/custom_anchor_video_list/create/
Authentication & shop
| Name | In | Type | Sample | Description |
|---|---|---|---|---|
| Authorization | header | header | Bearer q360_live_ab12cd34_… | Khóa API của brand (tạo ở mục API key). Bắt buộc với mọi request. Brand suy từ key — không truyền mã brand. |
| platform_shop_id | query | string | 7000000000000000001 | Tài sản TikTok Business đã kết nối — "Mã tài sản" ở trang Nền tảng hoặc GET /v1/platforms (tài khoản quảng cáo cho Marketing API, tài khoản TikTok cho Organic / Messaging). Có thể bỏ khi chỉ kết nối một tài sản. |
Request parameters
| Name | In | Type | Required | Sample | Description |
|---|---|---|---|---|---|
| store_id | body | string | Yes | The ID of a TikTok Shop.
To obtain a TikTok Shop that is available for GMV Max Campaigns, use /gmv_max/store/list/ and confirm that the returned is_gmv_max_available is true. | |
| store_authorized_bc_id | body | string | Yes | The ID of the Business Center that is authorized to access the TikTok Shop (store_id).
To obtain the ID, check the store_authorized_bc_id for the store_id returned from /gmv_max/store/list/. | |
| custom_anchor_video_list | body | object[] | Yes | The details of your videos and the products you want to link them to.
By linking videos to a product at the TikTok Shop level, you can generate shop-level customized TikTok posts. The system will automatically add these shop-level customized TikTok posts to your Product GMV Max Campaign (with shopping_ads_type set to PRODUCT) if you use the Autoselect creative mode (with product_video_specific_type as AUTO_SELECTION) and your campaign includes the linked product.
Max size: 200. |
Request examples
curl -s -X POST "https://partner.quantri360.com/v1/tiktok_business/gmv_max/creation/custom_anchor_video_list/create/" \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/json" \
-d '{"store_id":"","store_authorized_bc_id":"","custom_anchor_video_list":[{"item_id":"","identity_info":{"identity_id":"","identity_type":""},"spu_id_list":[]}]}'
Python
import requests
KEY = "q360_live_..." # khóa API của brand
r = requests.post(
"https://partner.quantri360.com/v1/tiktok_business/gmv_max/creation/custom_anchor_video_list/create/",
params={},
json={
"store_id": "",
"store_authorized_bc_id": "",
"custom_anchor_video_list": [
{
"item_id": "",
"identity_info": {
"identity_id": "",
"identity_type": ""
},
"spu_id_list": []
}
]
},
headers={"Authorization": f"Bearer {KEY}"},
timeout=60,
)
print(r.status_code)
print(r.json())Node.js
const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/tiktok_business/gmv_max/creation/custom_anchor_video_list/create/');
for (const [k, v] of Object.entries({})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
method: 'POST',
headers: { Authorization: `Bearer ${KEY}`, 'Content-Type': 'application/json' },
body: JSON.stringify({"store_id":"","store_authorized_bc_id":"","custom_anchor_video_list":[{"item_id":"","identity_info":{"identity_id":"","identity_type":""},"spu_id_list":[]}]}),
});
console.log(r.status, await r.json());PHP
<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/tiktok_business/gmv_max/creation/custom_anchor_video_list/create/' . '?' . http_build_query([]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key, 'Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"store_id":"","store_authorized_bc_id":"","custom_anchor_video_list":[{"item_id":"","identity_info":{"identity_id":"","identity_type":""},"spu_id_list":[]}]}');
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;Response
Response fields (as returned by TikTok Business)
| Name | Type | Sample | Description |
|---|---|---|---|
| code | number | Response code. For the complete list of response codes and descriptions, see Appendix - Return Codes. | |
| message | string | Response message. For details, see Appendix - Return Codes. | |
| request_id | string | The log ID of the request, which uniquely identifies a request. | |
| data | object | Returned data. | |
| failure_list | object | The list of shop-level customized TikTok posts that could not be successfully created. | |
| item_id | object[] | The ID of a TikTok video you intended to use in the customized post. | |
| identity_info | string[] | Information about the identity (TikTok account) associated with the TikTok video. | |
| identity_id | object | Identity ID. | |
| identity_type | string | Identity type. Enum values: - `AUTH_CODE`: Authorized User. This type of identity is created when you use the authorization code to access a TikTok account or a TikTok post. - `TT_USER`: TikTok User. This type of identity is created when you bind your TikTok For Business account with your TikTok Business Account, or when you bind your TikTok For Business account with your regular TikTok account and then upgrade the account to Business Account. - `BC_AUTH_TT`: TikTok Account User in Business Center. This type of identity is created when you add a TikTok account to your Business Center, and the TikTok account owner approves your request. - `TTS_TT`: TikTok Account User for TikTok Shop. This type of identity is created when you set an official TikTok account for the TikTok Shop. | |
| identity_authorized_bc_id | string | The ID of the Business Center that a TikTok Account User in Business Center identity is associated with. | |
| identity_authorized_shop_id | string | The ID of the TikTok Shop that a TikTok Account User in Business Center identity is associated with. | |
| store_id | string | The ID of the TikTok Shop that a TikTok Account User for TikTok Shop identity is associated with. | |
| spu_id_list | string | The SPU IDs of the products to link to the video. | |
| reason | string | The reason for the failure. Enum values: - `IDENTITY_NO_PERMISSION`: You do not have the required permissions for this identity. - `INVALID_PARAMETER`: Invalid parameters are submitted. - `AUTH_CODE_CAN_NOT_CHANGE_ANCHOR`: The anchor in the video cannot be changed without user permission. - `ITEM_NOT_FOUND`: The TikTok video cannot be found. - `NATIVE_ANCHOR_EXISTS`: The product link you want to add is the same as the product link already present in the video. | |
| error_message | string | The detailed error message. |
Response sample
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"failure_list": []
}
}
Get started
- Sign up for Partner
- Enable a data type of the Ads (Marketing API) group on the platform page
- Create an API key (tick the TikTok Business channel)
- Call it as in the examples above