stable本次发布有变化全部展示
来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 For All Market New Affiliate Seller APIs: Creator Outreach Quota, Creator Promotion Performance, and Affiliate IM Inbox Management
For All Market New Affiliate Seller APIs: Creator Outreach Quota, Creator Promotion Performance, and Affiliate IM Inbox Management
§2 Summary
Summary
We have released 6 new Affiliate seller APIs and upgraded 4 existing ones. Sellers and ISVs can now check the outreach quota before reaching out to creators, collect outreach results afterwards, drill down into a creator's promotion performance product by product inside a target collaboration, and manage the Affiliate IM inbox with starring, archiving, and category counts. Upload Message Image V2 also fixes the issue where images uploaded by US cross-border sellers through the previous version were not accessible to creators. All changes to existing endpoints are backward compatible: no field or behavior is removed, and no new permission scope is introduced, so already-authorized apps do not need to be re-authorized.
§3 Impact
Impact
| Item | Detail |
|---|---|
| Impacted market(s) | All markets |
| Seller type(s) | All seller types (local and cross-border) |
| Permission scope | Existing Affiliate scopes are reused. No new permission scope, and no re-authorization is required |
| Impacted version(s) | 202412, 202508, 202607, 202608 |
| Compatibility | No breaking change. Only optional request fields, new response fields, and new enum values are added |
§4 Changes by API
Changes by API
New = released for the first time.
Update = backward-compatible upgrade of an existing endpoint. All paths are relative to https://open-api.tiktokglobalshop.com.
§5 Target collaboration
Target collaboration
| API | What changed | Problem it solves |
|---|---|---|
Create Target Collaboration Update · POST /affiliate_seller/202508/target_collaborations | Added the optional request field preferred_content_type, the preferred creator content type. Supported values: LIVE, VIDEO. | Sellers could not tell creators which content format they expect, so a campaign built for LIVE selling could be fulfilled with videos only. The expected fulfillment format can now be declared when the invitation is created. |
Search Target Collaborations Update · POST /affiliate_seller/202508/target_collaborations/search | Added the response field create_time. Invitations can be located with search_param.keyword plus search_param.keyword_type: PRODUCT_ID, PRODUCT_NAME, TARGET_COLLABORATION_ID, TARGET_COLLABORATION_NAME. | Sellers with hundreds of invitations had to paginate the whole list and could not tell when an invitation was created. They can now search by product or invitation and sort or filter by creation time. |
Query Creator Promotion Details in Target Collaboration New · POST /affiliate_seller/202608/target_collaborations/creator_promotion_details/query | Returns the promotion details of one creator for the products of one target collaboration. Request: creator_user_open_id, invitation_group_id, invitation_id, query + query_type, product_filter.added_types. Response product_details[]: video_count, live_count, target_commission, open_commission, target_ads_commission, product_add_status, is_commission_effective, commission_effective_time. | After an invitation was accepted, sellers had no product-level view of what the creator actually delivered, so re-investment and commission decisions were made blind. Dashboards can now show commission rate, promotion video count, and promotion LIVE count per product. |
§6 Creator outreach quota
Creator outreach quota
| API | What changed | Problem it solves |
|---|---|---|
Get Weekly Creator Outreach Quota New · GET /affiliate_seller/202607/creator_outreach/quota | Returns the shop's outreach quota for the current period: gmv_tier, quota_sum, quota_use, unlimited, reached_max_follower_cnt, new_connect_count, pair_connect_count, start_time, end_time, and the tier rules in gmv_level_rule[]. | Bulk outreach used to fail as a whole when the weekly quota ran out or a creator exceeded the follower cap, with no way to check in advance. Tools can now split batches by the remaining quota (quota_sum - quota_use), filter creators above reached_max_follower_cnt, and show what the next GMV tier unlocks. |
Get Weekly Creator Outreach Records New · POST /affiliate_seller/202608/creator_outreach/records/query | Returns paginated outreach records (page_index, page_size): total and connect_list[] with creator_open_id, has_sent_im_message, has_sent_invitation, is_paired. | Sellers could not tell which creators had already been messaged or invited in the period, so duplicate outreach burned quota and the funnel could not be measured. The records now support deduplication lists and a has_sent_im_message → has_sent_invitation → is_paired funnel. |
§7 Affiliate IM
Affiliate IM
| API | What changed | Problem it solves |
|---|---|---|
Send IM Message Update · POST /affiliate_seller/202412/conversations/{conversation_id}/messages | msg_type now also supports two CRM cards, in addition to TEXT, PRODUCT_CARD, TARGET_COLLABORATION_CARD, FREE_SAMPLE_CARD, and IMAGE: CRM_TEXT_WITH_IMAGE_CARD ({"image_url","title","content"}) and CRM_TEXT_WITH_PRODUCTS_CARD ({"product_ids","title","content"}, up to 5 product IDs). | Outreach messages were plain text or a single product card, which is weak for campaign announcements and multi-product pitches. Sellers can now send a branded image-and-text card, or one card with up to 5 products, which improves creator response rates and saves IM quota. |
Get Conversation List Update · GET /affiliate_seller/202412/conversations | Added the optional query parameter conversation_status: ALL, UNREAD, UNREPLIED, STARRED, ARCHIVED. | The list could only be returned in full, so sellers with a large inbox could not pull just the conversations that need action. Follow-up queues can now be built from UNREPLIED or STARRED, and archived conversations can be excluded. |
Update Conversation Status New · POST /affiliate_seller/202608/conversations/{conversation_id}/status | Stars, unstars, or archives one conversation through the required action field: STARRED, UNSTARRED, ARCHIVED. The response body is empty. | Priority creators and closed conversations could not be marked through the API, so third-party workbenches could not keep the same inbox state as Seller Center. Key conversations can now stay starred and finished ones can leave the working view. |
Get Inbox Category Counts New · GET /affiliate_seller/202608/conversations/group_counts | No business request parameters. Returns group_counts[] with group_type (UNREAD, UNREPLIED, STARRED, ARCHIVED) and count. | Unread and unreplied badges previously required paginating the whole conversation list, which was slow and consumed call quota. One call now feeds all inbox badges. |
Upload Message Image V2 New · POST /affiliate_seller/202608/media/upload | Uploads an image with content-type: multipart/form-data and the required file field data (jpg, gif, webp, png, up to 10MB). Returns url, width, and height for IMAGE messages and CRM image cards. | Images uploaded by US cross-border sellers through the previous Upload Message Image were not accessible to creators, so image messages and CRM cards were broken for those shops. V2 returns an accessible URL. |