Searches for open-collaboration products on the TikTok Shop Affiliate Product Marketplace within the regions where the seller is registered to sell. Category, commission rate, sales price, and title keyword filters are optional. When multiple filter groups are supplied, a product must match every supplied group. When none of these filter groups is supplied, no filter from these groups is applied; results remain scoped to eligible open-collaboration products in the seller’s registered regions and are returned through pagination.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Identifies the shop. Obtain it from the Get Authorized Shops API.
The sort order for the sort_field parameter. Default: ASC Possible values:
- ASC: Ascending order
- DESC: Descending order
The returned results will be sorted by the specified field. See the description of the field values in the request body for more information about each field. Default: commission_rate Possible values:
- commission_rate
- product_sales_price
- commission
- units_sold
An opaque token used to retrieve the next page of a paginated result set. Retrieve this value from the result of the next_page_token from a previous response. It is not needed for the first page.
The number of results to be returned per page. Valid range: [1-20].
Request Body
Section titled “Request Body”object
A list of product keywords. Product titles, or names, are loosely matched. Keywords in the list form a query and the resulting set of matching product names is based on the conjunctive operator AND between each keyword. For example, the keyword list ["Men", "Fashion"] creates a query "Men" AND "Fashion" and the resulting set of matching product names contains the loosely matched conjuction of “Men” and “Fashion” such as “Male Fashionable”. Maximum length of the list is 20 keywords. Maximum keyword string length is 255 characters.
Restricts the products in the search results to those with prices greater than or equal to the expressed minimum price and less than the expressed maximum price
object
The product price must be greater than this value in order to be included in the search results. The value must be greater than 0.
The product price must be greater than this value in order to be included in the search results. The value must be greater than 0. No upper bound is set if this property is not included.
Restricts the products in the search results to those that are associated with the expressed product category.
object
The category ID.
Filters products by the commission rate range specified by rate_ge and rate_lt.
object
Products with a commission rate greater than or equal to this value are included in the search results. The rate is expressed in hundredths of a percent; for example, 3587 means 35.87%. Valid range: [100, 8000].
The commission rate must be less than this value in order to be included in the search results. The commission rate is expressed in hundredths of a percent. For example, 3587 is a commission rate of 35.87%. This value must a minimum of 100.
Example
{ "title_keywords": [ "Men", "Fashion", " Sports Short" ], "sales_price_range": { "amount_ge": "12.44", "amount_lt": "100" }, "category": { "id": "3412342" }, "commission_rate_range": { "rate_ge": 100, "rate_lt": 8000 }}Responses
Section titled “Responses”Success
object
Status code; 0 means success.
Success or failure message.
Request log ID.
object
The list of products meeting the search criteria expressed in the request body.
object
Data and metadata associated with the Seller’s TikTok Shop.
object
The name of the shop to which the product belongs.
The product identifier.
Set to true if there are more than zero units of the product in inventory. Set to false if there are zero units in inventory.
Total number of units sold. Units are indexed to SKU. Note that if the creator has not given permission for precise data sharing, this property will not be present.
The product name.
The region where the product is offered for sale.
The product image URL.
The URL for the product’s detail page.
The original price of the product.
object
The currency in the sale region.
The minimum original price of all skus of this product.
The maximum original price of all skus of this product.
A list of categories associated with the product. Maximum length of the list is 3 categories.
object
The current category id of this product.
The current level category name of this product.
Indicate whether current node is leaf node
The category id of its parent category
Metadata and data associated with the commission rates for the product.
object
- The commission rate for this product is set by merchants for creators public promotion.
- The range of this value is [100, 8000].
- This value equals actual commission rate multi 10000. For example: 3000 means the actual commission rate is 30.00%, and 3555 means 35.55%
Currency code for the commission amount.
The commission amount calculated from the product’s promotional price and commission rate. When both minimum and maximum promotional prices are available, the value is formatted as <minimum commission> - <maximum commission>; otherwise, it contains the available commission amount. If neither price is available, the value is 0. The currency is specified by commission.currency.
Metadata and data associated with the sale price of the product
object
Currency code for the promotional price.
The minimum promotion price of all skus of this product.
The maximum promotion price of all skus of this product.
An opaque token used to retrieve the next page of a paginated result set. If this value is non-empty, pass it as page_token in the next request and keep shop_cipher, page_size, sort_field, sort_order, and the request body unchanged. An empty value means that there are no more pages.
Total count of products meeting the search criteria expressed in the request body.
Example
{ "code": 0, "data": { "products": [ { "shop": { "name": "Test shop" }, "id": "1729432087292775344", "has_inventory": false, "units_sold": 12123, "title": "Blue t-shirt", "sale_region": "ID", "main_image_url": "https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/fa0387fa5a204dcfa44d5be75877a163~tplv-o3syd03w52-origin-webp.webp?from=3478900499", "detail_link": "https://shop.tiktok.com/view/product/1729624807198591373?region=ID&local=en", "original_price": { "currency": "USD", "minimum_amount": "12.21", "maximum_amount": "100.00" }, "category_chains": [ { "id": "343554", "local_name": "COMPUTER", "is_leaf": false, "parent_id": "342948" } ], "commission": { "rate": 3000, "currency": "USD", "amount": "121.32" }, "sales_price": { "currency": "USD", "minimum_amount": "34.3", "maximum_amount": "55.7" } } ], "next_page_token": "b2Zmc2V0PTEw", "total_count": 10000 }, "message": "Success", "request_id": "202203070749000101890810281E8C70B7"}