Search Target Collaborations

This API is used by Seller to search for all existing target collaborations. Sellers can search based on filters such as Invitation name, Invitation ID, Product name, Product ID and Creator name.

---

For common parameters, refer to How to call TikTok Shop APIs - Common Parameters

• "ACCEPT", it means creators have already added the products to the showcase
• "ALL""", it means regardless of whether the creator adds the product to the Showcase. By default, the target collaborations will be searched by "ALL" status. | free_sample_setting |string |N |WITH_FREE_SAMPLE |Filtering by target collaborations' free sample setting. You can query based on:
• "WITH_FREE_SAMPLE"
• "ALL" By default, the target collaborations will be searched by "ALL" setting. | search_param |object |N | |The search param. | ^keyword_type |string |Y |TARGET_COLLABORATION_NAME |Pass in the parameter type which you use to search for target collaborations. You can query based on:
• PRODUCT_ID：If you use PRODUCT_ID to search, you can search for target collaboration information for a specified product ID.
• PRODUCT_NAME: If you use PRODUCT_NAME to search, you can fuzzy search for target collaboration information involving related product names.
• TARGET_COLLABORATION_ID: if you use Target_Collaboration_ID to search, you can search for target collaboration information for a specified target collaboration ID.
• TARGET_COLLABORATION_NAME: If you use Target_Collaboration_NAME to search, you can fuzzy search for target collaboration information involving related target collaboration names. | ^keyword |string |Y |test |Search Keyword. | creator_user_open_id |string |N |uACafQAAAABmUU2qon4R0vUYvUVS3QC6CICP2m5A2-wd77j8R9G0yg |Creators' TikTok User Open ID.More details
• CREATOR_OPEN_ID: If you use CREATOR_OPEN_ID to search, you can search for target collaboration information for a specified creator ID. | collaboration_status |string |Y |ONGOING |Filtering by target collaborations' status. You can query based on:
• ONGOING: If you use ONGOING to search, the remaining validity period of the returned target collaborations will be greater than 7 days.
• EXPIRING: If you use EXPIRING to search, the remaining validity period of the returned target collaborations will be less than 7 days.
• VALID: If you use VALID to search, all returned target collaborations will be valid.
• CANCELING: If you use CANCELING to search, all returned target collaborations will be in the process of canceling.
• COMPLETED: If you use COMPLETED to search, all returned target collaborations will be in the state of completed, including expired and canceled. |

Query

https://open-api.tiktokglobalshop.com/affiliate_seller/202508/target_collaborations/search?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1625484268&shop_cipher=ROW_RHkDDABBAAB8tKAVoAqsMTjsQZFLyNfY&page_size=20&page_token=b2Zmc2V0PTAK

Body

{"creator_accept_status":"ACCEPT","free_sample_setting":"WITH_FREE_SAMPLE","search_param":{"keyword_type":"TARGET_COLLABORATION_NAME","keyword":"test"},"creator_user_open_id":"uACafQAAAABmUU2qon4R0vUYvUVS3QC6CICP2m5A2-wd77j8R9G0yg","collaboration_status":"ONGOING"}

• STANDARD: The target collaboration is created by sellers manually selecting products and creators.
• TOP_CREATOR_PROGRAM: The target collaboration created by seller joining TikTok Shop Top Creator Program, requiring only product submission. |

{"code":0,"data":{"total_count":100,"next_page_token":"b2Zmc2V0PTAK","target_collaborations":[{"id":"789078671231123124","name":"target_collaboration","message":"test","start_time":1715654330,"end_time":1715654330,"create_time":1715654330,"update_time":1715654330,"creator_inivited_count":10,"showcase_creator_count":2,"content_creator_count":1,"product_count":30,"free_sample_rule":{"has_free_sample":true,"is_sample_approval_exempt":true},"type":"STANDARD"}]},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}

For common error codes, refer to How to call TikTok Shop APIs - Common Error Code