Get Creator Applicable Sample Label

Check if a creator can apply for a sample of a specific product.

---

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

Query

https://open-api.tiktokglobalshop.com/affiliate_creator/202412/samples/labels?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1625484268&product_id=1729480364147774364

• TO_APPLY: creator has not applied this product as a free sample.
• ONGOING: creator applied this product as a free sample while he/she has not finished sample fulfillment.
• COMPLETE: creator applied this product as a free sample and finished sample fulfillment. | ^^application_id |string |86427198341982134 |Sample Application ID. only appear when the creator has already applied this product. | ^^reach_limit |bool |true |If the creator has reached the sample application upper limit. | ^^sample_product |object | |The sample product information. | ^^^sample_sku_list |[]object | |The sample product SKU information. | ^^^^id |string |1731055098570377347 |The SKU identifier. | ^^^^sale_property_value_ids |string |7068196393634072325 |The combination of SKU properties for this SKU. | ^^^^price |object | |SKU price information. | ^^^^^amount |string |7588986 |The price amount. | ^^^^^currency |string |USD |The price currency code. | ^^^^sale_properties |[]object | |The SKU property information. | ^^^^^id |string |100000 |A SKU property identifier, short for "Stock Keeping Unit Property ID", is a specific identification code assigned to a particular property or characteristic of a SKU.(i.e: "100000" means "color") | ^^^^^name |string |color |The SKU property name. | ^^^^^value_id |string |7425668826861520646 |The SKU property value identifier is an identification code related to the specific values of the properties of a Stock Keeping Unit (SKU). When a SKU has certain properties like color, size, etc., each possible value for those properties has its own unique SKU property value identifier. For instance, if the property is "color" and the possible values are "red", "blue", "green", then "red" would have its own SKU property vvalue identifier, "blue" would have another one, and so on. | ^^^^^value_name |string |Default |The SKU property value name. | ^^^^is_available |bool |true |If this SKU is available. | ^^^^unavailable_reason |string |IS_PREORDER |The reason why the SKU is unavailable:
• IS_PREORDER : this product is a preorder product which does not support free sample
• IS_GIFT: this product is a gift product which does not support free sample
• OUT_OF_STOCK: product sold out
• EXCEED_CB_PRICE_THRESHOLD:
• ALREADY_APPLYED: creator has already applied this SKU. |

{"code":0,"data":{"label":{"can_apply":true,"status":"ONGOING","application_id":"86427198341982134","reach_limit":true,"sample_product":{"sample_sku_list":[{"id":"1731055098570377347","sale_property_value_ids":"7068196393634072325","price":{"amount":"7588986","currency":"USD"},"sale_properties":[{"id":"100000","name":"color","value_id":"7425668826861520646","value_name":"Default"}],"is_available":true,"unavailable_reason":"IS_PREORDER"}]}}},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}

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