Get Showcase Products

This API lists the products in the creator's showcase, paginated by specified page size and iterated through pages by page token for up to 2000 products in the showcase. This API is generally used when a creator would like to view the products in the showcase. The platform will return the product details in the showcase, as well as the products in the livebag if the creator is live streaming.

---

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

Query

https://open-api.tiktokglobalshop.com/affiliate_creator/202405/showcases/products?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1625484268&page_size=10&page_token=V231as2V0PTAK&origin=LIVE

• IN_STOCK
• SOLD_OUT | ^^^review_status |string |APPROVED |The product review status. This is an enumerated type with values:
• APPROVED
• CHANGES_UNDER_REVIEW
• UNAVAILABLE
• ZERO_COMMISSION | ^^^is_hidden |bool |false |Set to false if the product is visible in the showcase. Set to true if the product is hidden from the showcase. | ^^^added_status |string |ADDED |The product showcase status. This is an enumerated type with values:
• NOT_ADDED
• ADDED
• REJECTED | ^^source |string |AFFILIATE |The product source. This is an enumerated type with values:
• THIRD_PARTY
• AFFILIATE
• TIKTOK_STORE | ^^detail_link |string |https://shop.tiktok.com/view/product/248901892031?region=US&local=en |The product detail page URL. | ^^third_party_link |string |https://storename.myshopify.com/products/gold-bracelet-engraved-with-diamonds |The off-TikTok Shop product detail page URL. | ^^sale_regions |[]string |["US"] |A list of regions in which the product is offered for sale. | ^^commission |object | |An object including data about commissions associated with the product. | ^^^rate |int |3000 |The commission rate in hundredths of a percent. For example, 3587 is a commission rate of 35.87%. The range of this value is [100, 8000]. | ^^^reward_rate |int |500 |The reward commission rate in hundredths of a percent. For example, 3587 is a commission rate of 35.87%. | ^^collaboration |object | |An object including data about open or target collaboration for the product. | ^^^id |string |7495383576027499219 |The open or target collaboration identifier. | ^^^type |string |OPEN |The collaboration type. This an enumerated type with values: 1 - Open Collaboration 2 - Target Collaboration 5 - Partner Campaign 11 - Flat Fee 12 - Collaboration Plus 13 - Affiliate Promotion | ^^^partner |object | |The partner information. | ^^^^id |string |123456789 |The partner identifier. | ^^^^name |string |Partner Name |The partner name. | ^next_page_token |string |V231as2V0PTAK |An opaque token used to retrieve the next page of a paginated result set. | ^total_count |int |15 |Total count of products in the response. |

{"code":0,"data":{"products":[{"id":"53219092314","shop":{"name":"Gift store"},"addition":{"customized_main_images":[{"width":100,"heigth":100,"url":"https://p16-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/d76b8cc1b598de90ad5048df46e672b3~c5_100x100.webp?x-expires=1691895600\u0026x-signature=oAT9KOL7aCN3Did9U%2FoKEsbBDj0%3D"}]},"price":{"original_price":{"minimum_amount":"12.21","maximum_amount":"100.00","currency":"USD"},"seller_discount_price":{"minimum_amount":"12.21","maximum_amount":"100.00","currency":"USD"},"platform_discount_price":{"minimum_amount":"12.21","maximum_amount":"100.00","currency":"USD"}},"title":"Chirstmas Gift","main_images":[{"width":100,"heigth":100,"url":"https://p16-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/d76b8cc1b598de90ad5048df46e672b3~c5_100x100.webp?x-expires=1691895600\u0026x-signature=oAT9KOL7aCN3Did9U%2FoKEsbBDj0%3D"}],"status":{"inventory_status":"IN_STOCK","review_status":"APPROVED","is_hidden":false,"added_status":"ADDED"},"source":"AFFILIATE","detail_link":"https://shop.tiktok.com/view/product/248901892031?region=US\u0026local=en","third_party_link":"https://storename.myshopify.com/products/gold-bracelet-engraved-with-diamonds","sale_regions":["US"],"commission":{"rate":3000,"reward_rate":500},"collaboration":{"id":"7495383576027499219","type":"OPEN","partner":{"id":"123456789","name":"Partner Name"}}}],"next_page_token":"V231as2V0PTAK","total_count":15},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}

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