# Tiktok product search-v2 #### Tiktok product search This endpoint retrieves TikTok shop product feeds with the option to sort by units sold, limit the number of results, and filter by title keywords. **Parameters** * `sort_field` (query parameter, required): Specifies the field to sort the results by. * 1\. "**RECOMMENDED**" Follow the algorithm recommended order * 2\. "**BEST\_SELLERS**" Sort by historical sold numbers from high to low * 3\. "**LOW\_PRICE**" Sort by price from low to high * 4\. "**HIGH\_PRICE**" Sort by price from high to low * 5\. "**NEWLY\_RELEASED**" Sort by the product edition time from late to early * 6\. "**HIGH\_COMMISSIOM\_RATE**" Sort by commission rate from high to low" * `limit` (query parameter, required): Limits the number of results to be returned. In this example, the value is `20`. * `title_keywords` (query parameter, required): Filters the results by title keywords. In this example, the values are `Khăn giấy` and `Khăn ướt`. #### \[Example] Tiktok product search ```curl curl --location -g '{{local}}/v2/tiktokshop_product_feeds?sort_field=RECOMMENDED&limit=10&title_keywords=tr%E1%BA%BB%20em&page_token=b2Zmc2V0PTEw&product_ids=1730264365926091505' \ --header 'accept: application/json, text/plain, */*' \ --header 'accept-language: en-US,en;q=0.6' \ --header 'authorization: Token {{token_local}} ' \ --header 'content-type: application/json' \ --header 'origin: https://pub2.accesstrade.vn' \ --header 'priority: u=1, i' \ --header 'referer: https://pub2.accesstrade.vn/' \ --header 'sec-ch-ua: "Chromium";v="136", "Brave";v="136", "Not.A/Brand";v="99"' \ --header 'sec-ch-ua-mobile: ?0' \ --header 'sec-ch-ua-platform: "macOS"' \ --header 'sec-fetch-dest: empty' \ --header 'sec-fetch-mode: cors' \ --header 'sec-fetch-site: same-site' \ --header 'sec-gpc: 1' \ --header 'user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36' \ --data '' ``` **Response** Upon a successful request, the server returns a JSON object with the following structure: ```json { "data": { "next_page_token": "", "products": [ { "category_chains": [ { "id": "", "is_leaf": true, "local_name": "", "parent_id": "" } ], "commission": { "amount": "", "currency": "", "rate": 0 }, "detail_link": "", "has_inventory": true, "id": "", "main_image_url": "", "original_price": { "currency": "", "maximum_amount": "", "minimum_amount": "" }, "sale_region": "", "sales_price": { "currency": "", "maximum_amount": "", "minimum_amount": "" }, "shop": { "name": "" }, "title": "", "units_sold": 0 } ], "total_count": 0 }, "status": true } ``` The `data` object contains the retrieved product feeds, including the `products` array, which holds the details of each product. The `total_count` indicates the total number of products available. ``` data ├── products: [] │ └── object (A list of products.) ├── shop: object │ ├── name: string (The TikTok Shop name.) │ └── id: string (The product identifier.) ├── has_inventory: bool (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.) ├── units_sold: int (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.) ├── title: string (The product name.) ├── sale_region: string (The region where the product is offered for sale.) ├── main_image_url: string (The product image URL.) ├── detail_link: string (The URL for the product's detail page.) ├── original_price: object │ ├── currency: string (The currency code.) │ ├── minimum_amount: string (The lowest original price of all SKUs of the product.) │ └── maximum_amount: string (The highest original price of all SKUs of the product.) ├── category_chains: [] │ └── object (A list of categories associated with the product. Maximum length of the list is 3 categories.) │ ├── id: string (The category identifier.) │ ├── local_name: string (The name of the product in the category.) │ ├── is_leaf: bool (Set to true if this category is a leaf node. Set to false if not.) │ └── parent_id: string (The category identifier of the parent category.) ├── commission: object │ ├── rate: int (The commission rate in hundredths of a percent. For example, 3587 is a commission rate of 35.87%. This value must a minimum of 1000. The range of this value is [100, 8000].) │ ├── currency: string (The currency code.) │ └── amount: string (The commission amount.) ├── sales_price: object │ ├── currency: string (The currency code.) │ ├── minimum_amount: string (The lowest promotion price of all SKUs of this product.) │ └── maximum_amount: string (The highest promotion price of all SKUs of this product.) ├── next_page_token: string (An opaque token used to retrieve the next page of a paginated result set.) └── total_count: int (Total count of products meeting the search criteria expressed in the request body.) ``` **Example** ```http GET https://api-v1.dev.accesstrade.me/v1/tiktokshop_product_feeds?sort_field=units_sold&limit=20&title_keywords=Khăn giấy &title_keywords=Khăn ướt ``` | **Tên Header** | **Giá trị** | | ---------------------- | ----------------------------------------------------------------------------------------------------------------------- | | **accept** | application/json, text/plain, */* | | **accept-language** | en-US,en;q=0.6 | | **authorization** | Token {{token\_local}} *(Token của user lấy tại link)* | | **content-type** | application/json | | **origin** | | | **priority** | u=1, i | | **referer** | | | **sec-ch-ua** | "Chromium";v="136", "Brave";v="136", "Not.A/Brand";v="99" | | **sec-ch-ua-mobile** | ?0 | | **sec-ch-ua-platform** | "macOS" | | **sec-fetch-dest** | empty | | **sec-fetch-mode** | cors | | **sec-fetch-site** | same-site | | **sec-gpc** | 1 | | **user-agent** | Mozilla/5.0 (Macintosh; Intel Mac OS X 10\_15\_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36 | | **Trường** | **Giá trị** | | ------------------- | --------------------------------------------------------------------------------------------------------- | | **sort\_field** | HIGH\_COMMISSION\_RATE | | | *Mặc định nếu bỏ trống sẽ là "RECOMMENDED"* | | | **Các giá trị hợp lệ:** | | | - "RECOMMENDED" – Sắp xếp theo thứ tự đề xuất của thuật toán | | | - "BEST\_SELLERS" – Sắp xếp theo số lượng bán trong lịch sử từ cao đến thấp | | | - "LOW\_PRICE" – Sắp xếp theo giá từ thấp đến cao | | | - "HIGH\_PRICE" – Sắp xếp theo giá từ cao đến thấp | | | - "NEWLY\_RELEASED" – Sắp xếp theo thời gian ra mắt sản phẩm từ mới đến cũ | | | - "HIGH\_COMMISSION\_RATE" – Sắp xếp theo tỷ lệ hoa hồng từ cao đến thấp | | **limit** | 10 | | **title\_keywords** | dép | | **page\_token** |

b2Zmc2V0PTEw
\Token của trang tiếp theo được trả trong response "next\_page\_token"\

| | **product\_ids** | 1730264365926091505 | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://developers.accesstrade.vn/api-publisher-vietnamese/tich-hop-api-publisher-at-cho-chien-dich-tiktok-shop/version-2-updated-version/tiktok-product-search-v2.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.