# Tiktok product search-v1 #### GET - Tiktok product search giấy \&title\_keywords=Khăn ướt #### 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. * `commission` : hoa hồng * `units_sold`: số lượng bán * `product_sales_price`: giá bán * `commission_rate`: Tỉ lệ hoa hồng * `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`. **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 xxxx (Token của user lấy tại ) | | content-type | application/json | | origin | [https://pub2.accesstrade.vn](https://pub2.accesstrade.vn/) | | 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 | | **Tên Tham Số (Param)** | **Giá Trị** | **Ghi Chú** | | ----------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------- | | sort\_field | units\_sold | - `commission`: hoa hồng- `units_sold`: số lượng bán- `product_sales_price`: giá bán- `commission_rate`: Tỉ lệ hoa hồng | | limit | 20 | Số lượng kết quả trả về | | title\_keywords | Khăn giấy | Từ khóa tìm kiếm sản phẩm | | title\_keywords | Khăn ướt | Có thể gửi nhiều `title_keywords` | | page\_token | | Token của trang tiếp theo, lấy từ trường `"next_page_token"` trong response | --- # 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-1/tiktok-product-search-v1.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.