Get customized TikTok posts · call it through Quantri360 with one API key for your own accounts / assets that you connected and authorized — 360 handles request signing and refreshing the authorization you granted.
POST/gmv_max/creation/custom_anchor_video_list/get/Via 360: POST https://partner.quantri360.com/v1/tiktok_business/gmv_max/creation/custom_anchor_video_list/get/
Description
Use this endpoint to retrieve a list of shop-level and campaign-level customized TikTok posts created from an ad account for a specific TikTok Shop.
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. In contrast, campaign-level customized TikTok posts are generated by linking your TikTok videos to a product during the Product GMV Max Campaign creation process and are exclusive to the campaign.
Request
Endpoint
POST https://partner.quantri360.com/v1/tiktok_business/gmv_max/creation/custom_anchor_video_list/get/
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/.
creative_source
body
string
Yes
Creative source type.
Enum value:
- CUSTOMIZED: customized post.
spu_id_list
body
string[]
No
A list of Product SPU (standard product unit) IDs to filter the results by.
To obtain the list of SPU IDs for products within a TikTok Shop, use /store/product/get/. Set ad_creation_eligible to GMV_MAX and select item_group_id values where status is AVAILABLE and gmv_max_ads_status is UNOCCUPIED.
sort_field
body
string
No
The sorting field.
Enum values:
- GMV: GMV.
- POST_TIME: Post time.
- VIDEO_VIEWS: Video views.
- VIDEO_LIKES: Video likes.
- CLICK_THROUGH_RATE: Click-through Rate (CTR).
- PRODUCT_CLICKS: Product clicks.
Default value: GMV.
A search keyword to filter posts (videos).
You can specify a post ID or caption.
- To search by post caption (text), provide a text string. This search type supports multiple-language searches and fuzzy matches.
Example: summer.
- To search by post ID (item_id), provide a numeric string with at least 19 characters. This search type supports exact matches.
Example: 1234567891234567891.
need_auth_code_video
body
boolean
No
Whether to include posts associated with AUTH_CODE identities in the results.
Supported values: true, false.
Default value: false.
Note: If need_auth_code_video is false or not passed and identity_list is not specified, you will retrieve an empty post list.
identity_list
body
object[]
No
A list of TT_USER, BC_AUTH_TT, or TTS_TT identities to filter the results by.
To obtain a list of identities available for Product GMV Max Campaigns, use /gmv_max/identity/get/ and select identities with product_gmv_max_available as true.
Max size: 20.
Note: If need_auth_code_video is false or not passed and identity_list is not specified, you will retrieve an empty post list.
campaign_id
body
string
No
The ID of a Product GMV Max Campaign to filter the returns by.
You can use this field to filter campaign-level customized posts. If this field is not specified, the results will only include shop-level customized posts.
To retrieve existing Product GMV Max Campaigns within your ad account, use /gmv_max/campaign/get/ and set filtering to {"gmv_max_promotion_types":["PRODUCT_GMV_MAX"]}.
page
body
number
No
Current page number.
Value range: ≥ 1.
Default value: 1.
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.
item_list
object[]
A list of TikTok videos (posts) available for Product GMV Max campaigns using the specified TikTok Shop.
item_id
string
The ID of the TikTok post.
text
string
The caption of the TikTok post.
spu_id_list
string[]
The list of Product SPU IDs that the TikTok post is associated with.
Note: This field is not included in the response for videos with no product anchor link.
can_change_anchor
boolean
Whether you can change the product anchor link in this video.
Supported values:
- `true`: You can add a product anchor link to create a customized post.
- `false`: You cannot use the video to create a customized post.
Note: If `can_change_anchor` is `false`, you cannot pass the video to `custom_anchor_video_list` or `item_list` in /campaign/gmv_max/create/ or /campaign/gmv_max/update/ to create customized posts.
identity_info
object
Information about the identity associated with the TikTok post.
identity_id
string
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
Returned only when `identity_type` is `BC_AUTH_TT`.
The ID of the Business Center that a TikTok Account User in Business Center identity is associated with.
identity_authorized_shop_id
string
Returned for some `BC_AUTH_TT` identities.
The ID of the TikTok Shop that the TikTok Account User in Business Center identity is associated with.
store_id
string
Returned only when `identity_type` is `TTS_TT`.
The ID of the TikTok Shop that a TikTok Account User for TikTok Shop identity is associated with.
profile_image
string
Temporary profile image URL for the TikTok account that is associated with the identity.
Validity period: around 48 hours. The expiration time is included in the URL after the `x-expires` parameter, in the format of an Epoch/Unix timestamp in seconds.
Once the URL expires, you need to call /gmv_max/video/get/ to obtain a new URL.
display_name
string
The display name of the TikTok account that is associated with the identity.
video_info
object
Details of the video in the post.
video_id
string
The ID of the video.
video_cover_url
string
Temporary URL for the video cover.
Validity period: around 24 hours. The expiration time is included in the URL after the `x-expires` parameter, in the format of an Epoch/Unix timestamp in seconds.
Once the URL expires, you need to call /gmv_max/video/get/ to obtain a new URL.
preview_url
string
Temporary preview URL for the video.
Validity period: six hours.
Once the URL expires, you need to call /gmv_max/video/get/ to obtain a new URL.
height
number
The height of the video in pixels.
Example: 1920.
width
number
The width of the video in pixels.
Example: 1080.
bit_rate
number
The bit rate of the video in bps.
Example: 8500323.
duration
number
The duration of the video in seconds.
Example: 3.669.
size
number
The size of the video in bytes.
Example: 3898461.
signature
string
The MD5 of the video.
Example: `ab1cd2345e678fghi91jkl23b456m7no`.
format
string
The format of the video.
Example: `mp4`.
definition
string
The definition of the video.
Example: `1080p`.
fps
number
The frames per second (FPS) of the video.
Example: 27.