Seller Search Sample Applications

This API is provided for sellers to query sample applications based on various criteria such as products, creators, or application statuses. By using this API, sellers can retrieve detailed information about sample application records, including the creator's information and the specifics of each application.

---

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

• PENDING: The sample application is waiting for the seller's review.
• AWAITING_SHIPMENT: The application is approved, and the seller needs to ship the sample.
• SHIPPED: The sample has been shipped by the seller and is waiting for the creator to receive the package.
• CONTENT_PENDING: The creator has received the sample package and is expected to create content.
• REJECT_CANCELLED: The sample application has been rejected by the seller.
• OVERDUE_CANCELLED: The sample application has expired due to being overdue.
• UNFULFILL_CANCELLED: The creator did not fulfill the commitment to create content within the agreed timeframe.
• DEL_OPEN_COLLAB: Open collaboration has been deleted.
• SELLER_NOT_SHIP_CANCELLED: The seller did not ship the sample within the required timeframe.
• WITHDRAW_CANCELLED: The creator withdrew the sample application before the seller approved it.
• UNFULFILLABLE_CANCELLED: The application was cancelled due to reasons beyond the creator's control, making it impossible to create content.
• OPS_CANCELLED: The application was manually cancelled by operations staff.
• OPS_FAILED: The application was marked as failed by operations staff.
• OPS_COMPLETED: The application was manually marked as completed by operations staff.
• COMPLETED: The application is complete, and the creator has posted the content. This field allows for tracking the status of a sample application throughout its lifecycle, providing visibility into each stage of the process for sellers and creators. |

Query

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

Body

{"product_id":"123456","title":"product name","creator_user_oepn_id":"123456","username":"test_tt_name","target_collabration_id":"123456","order_id":"123456","status":"PENDING"}

• The range of this value is [0.01, 0.8]. | ^^status |string |PENDING |The status of sample applications. The possible enumerated values are:
• PENDING: The sample application is waiting for the seller's review.
• AWAITING_SHIPMENT: The application is approved, and the seller needs to ship the sample.
• SHIPPED: The sample has been shipped by the seller and is waiting for the creator to receive the package.
• CONTENT_PENDING: The creator has received the sample package and is expected to create content.
• REJECT_CANCELLED: The sample application has been rejected by the seller.
• OVERDUE_CANCELLED: The sample application has expired due to being overdue.
• UNFULFILL_CANCELLED: The creator did not fulfill the commitment to create content within the agreed timeframe.
• DEL_OPEN_COLLAB: The open collaboration plan has been deleted.
• SELLER_NOT_SHIP_CANCELLED: The seller did not ship the sample within the required timeframe.
• WITHDRAW_CANCELLED: The creator withdrew the sample application before the seller approved it.
• UNFULFILLABLE_CANCELLED: The application was cancelled due to reasons beyond the creator's control, making it impossible to create content.
• OPS_CANCELLED: The application was manually cancelled by operations staff.
• OPS_FAILED: The application was marked as failed by operations staff.
• OPS_COMPLETED: The application was manually marked as completed by operations staff.
• COMPLETED: The application is complete, and the creator has finished creating the content. | ^^order_id |string |123456 |The sample order is generated after the sample application is approved by seller | ^^available_quantity |int |50 |The remaining stock quota of a sample product. | ^^approve_expiration_time |int |1728674995 |The expire time for a seller to approve a sample application. | ^^shipment_expiration_time |int |1728674995 |The deadline for a seller to ship a sample for a sample application. | ^^tracking_number |string |123456 |The logistics tracking number for the sample application order | ^^fulfillment_status |string |ONGOING |It indicates the current status of the fulfillment process. The possible values are:
• PENDING: The creator is yet to fulfill the content creation obligation.
• ONGOING: Fulfillment is in progress; content has been created and is being evaluated against criteria.
• SUCCEED: Fulfillment has been successfully completed; the content meets the required standards.
• FAILED: Fulfillment failed; the content did not meet the required standards.
• OVERDUE: Fulfillment is overdue; the creator did not meet the deadline.
• SUSPEND: Fulfillment has been suspended.
• CANCELLED: Fulfillment has been cancelled, either by the creator or due to operational reasons.
• EXEMPTED: The creator has been exempted from the fulfillment obligation. | ^^is_approvable |bool |true |The sample application can be approved or not. | ^^disapprovable_reasons |[]string |["Product out of stock"] |The reasons why can not approve the sample application | ^^partner_name |string |ABC |The name of the partner if the sample application is submitted on behalf of a creator by an agency. It is only populated when an agency handles the application process instead of the creator directly. | ^^creator |object | |Creator detailed information. It includes various details such as the creator's TikTok user name, TikTok user id, and performance metrics related to creator e-commerce activities, such as sales, fulfillment rates, and other relevant statistics. | ^^^creator_open_id |string |uACafQAAAABmUU2qon4R0vUYvUVS3QC6CICP2m5A2-wd77j8R9G0yg |Creator Open ID. More details | ^^^username |string |test.name |TikTok User Name of a creator | ^^^nickname |string |Test Name |TikTok Nick Name of a creator | ^^^follower_count |int |200 |The number of creator's followers | ^^^avatar_url |string |https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068xxxxx |The URL of the creator's avatar image | ^^^gmv |object | |GMV generated by a creators' shoppable content over the past 30 days. It is formatted as a floating-point number with a currency symbol (e.g., "$1234.56"). If the creator has not authorized the disclosure of this information, the field returns an empty string. | ^^^^amount |string |500 |GMV amount | ^^^^currency |string |USD |currency | ^^^content_count |int |4 |The number of contents a creator has posted in the last 30 days. It is formatted as an integer. If the creator has not authorized the sharing of this information, the field returns an empty string. | ^^^fulfillment_percentage |string |60.50 |Sample fulfillment rate of a creator received sample from seller over the past 90 days, formatted as a floating-point percentage with two decimal places (e.g., "60.85%"). If the creator has not authorized the disclosure of this information, the field returns an empty string. | ^^^ec_video_view |int |1200 |The median number of creators' shoppable video views over the past 30 days. If the creator has not authorized the sharing of this information, the field returns an empty string. | ^^product |object | |product information | ^^^id |string |123456 |The product identifier. | ^^^title |string |A women dress |The product name of the product. | ^^^sku_id |string |123456 |The unique id of product sku which creator apply for as sample. | ^^^sku_image_url |string |https://p16-oec-va.ibyteimg.com/tos-malivaxxxxx |The URL of SKU image. | ^^^sku_name |string |Soft Cover |The description of sku |

{"code":0,"data":{"next_page_token":"aDU2dHIzMlFhME5CUzJKUDhDdVJhTDM1WmJkeFVTVW9LTkRaSnNaZCtuWjJXVU5CSDhlaA==","total_count":100,"sample_applications":[{"id":"123456","commission_rate":"0.1","status":"PENDING","order_id":"123456","available_quantity":50,"approve_expiration_time":1728674995,"shipment_expiration_time":1728674995,"tracking_number":"123456","fulfillment_status":"ONGOING","is_approvable":true,"disapprovable_reasons":["Product out of stock"],"partner_name":"ABC","creator":{"creator_open_id":"uACafQAAAABmUU2qon4R0vUYvUVS3QC6CICP2m5A2-wd77j8R9G0yg","username":"test.name","nickname":"Test Name","follower_count":200,"avatar_url":"https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068xxxxx","gmv":{"amount":"500","currency":"USD"},"content_count":4,"fulfillment_percentage":"60.50","ec_video_view":1200},"product":{"id":"123456","title":"A women dress","sku_id":"123456","sku_image_url":"https://p16-oec-va.ibyteimg.com/tos-malivaxxxxx","sku_name":"Soft Cover"}}]},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}

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