POST Search Products
Tìm kiếm sản phẩm Shop Scope bắt buộc: seller.product.basic Truy xuất danh sách sản phẩm đáp ứng các điều kiện đã chỉ định. API này sẽ chỉ trả về các thuộc tính sản phẩm chính. Bạn có thể truyền product ID được trả về vào Get Product API
để lấy thêm chi tiết về sản phẩm. Version 202502
POST/product/202502/products/search
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được cho phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của seller từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy seller access_token. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗi app sẽ có một key duy nhất. Vui lòng sử dụng key cụ thể được gán cho app của bạn. |
| sign Required | string | Chữ ký được tạo bởi thuật toán gen. Khi bạn gửi các API request đến TTS, bạn phải ký chúng để TTS có thể nhận diện người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trong tất cả các API request. Nhà phát triển có thể dùng giá trị này để chuyển đổi sang giờ địa phương. |
| page_size Required | int | Số lượng kết quả được trả về trên mỗi trang. Phạm vi hợp lệ: [1-100] |
| page_token | string | Một token mờ được dùng để truy xuất trang tiếp theo của tập kết quả được phân trang. Lấy giá trị này từ next_page_token trong kết quả của response trước đó. Không cần thiết cho trang đầu tiên. |
| shop_cipher Required | string | Sử dụng thuộc tính này để truyền thông tin shop khi gọi API. Việc không truyền đúng giá trị khi gọi API cho các shop xuyên biên giới sẽ trả về response không chính xác. Lấy bằng API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| status | string | Lọc sản phẩm dựa trên phiên bản gốc (base version) của sản phẩm. Nói cách khác, bộ lọc này không áp dụng cho các bản nháp hoặc chỉnh sửa sau khi đã đăng (post-live). Ví dụ, status=DRAFT chỉ trả về các sản phẩm chưa đăng ở trạng thái DRAFT, không phải các sản phẩm đang hoạt động có bản nháp đang hoạt động.Các giá trị có thể: - ALL- DRAFT- PENDING- FAILED- ACTIVATE- SELLER_DEACTIVATED- PLATFORM_DEACTIVATED- FREEZE- DELETEDMặc định: ALL |
| seller_skus | []string | Lọc sản phẩm theo các mã seller SKU này. |
| create_time_ge | int | Lọc sản phẩm để chỉ hiển thị những sản phẩm được tạo vào hoặc sau ngày và giờ đã chỉ định. Unix timestamp.Lưu ý:create_time_ge và create_time_le cùng nhau tạo thành điều kiện lọc theo thời gian tạo.- Nếu create_time_ge được điền nhưng create_time_le để trống, create_time_le sẽ mặc định là thời gian hiện tại.- Nếu create_time_le được điền nhưng create_time_ge để trống, create_time_ge sẽ mặc định là thời gian sớm nhất của shop. |
| create_time_le | int | Lọc sản phẩm để chỉ hiển thị những sản phẩm được tạo vào hoặc trước ngày và giờ đã chỉ định. Unix timestamp.Tham khảo lưu ý trong create_time_ge để biết thêm thông tin sử dụng. |
| update_time_ge | int | Lọc sản phẩm để chỉ hiển thị những sản phẩm được cập nhật vào hoặc sau ngày và giờ đã chỉ định. Unix timestamp.Lưu ý:update_time_ge và update_time_le cùng nhau xác định điều kiện lọc theo thời gian cập nhật.- Nếu update_time_ge được điền nhưng update_time_le để trống, update_time_le sẽ mặc định là thời gian hiện tại.- Nếu update_time_le được điền nhưng update_time_ge để trống, update_time_ge sẽ mặc định là thời gian sớm nhất của shop. |
| update_time_le | int | Lọc sản phẩm để chỉ hiển thị những sản phẩm được cập nhật vào hoặc trước ngày và giờ đã chỉ định. Unix timestamp.Tham khảo lưu ý trong update_time_ge để biết thêm thông tin sử dụng. |
| category_version | string | Lọc sản phẩm theo phiên bản cây danh mục.Các giá trị có thể tùy theo khu vực:- US: v2, đại diện cho cây danh mục 7 cấp.- Các khu vực khác: v1, đại diện cho cây danh mục 3 cấp.Mặc định: Trả về tất cả sản phẩm từ cả cây danh mục v1 và v2. |
| listing_quality_tiers | []string | Lọc sản phẩm theo bậc chất lượng listing của chúng.Các giá trị có thể:- POOR- FAIR- GOODMặc định: Trả về tất cảLưu ý: Chỉ khả dụng cho thị trường US. |
| listing_platforms | []string | Lọc sản phẩm theo nền tảng listing.Các giá trị có thể:- TOKOPEDIA- TIKTOK_SHOPMặc định: Trả về tất cả sản phẩm bất kể nền tảng listing của chúng.Chỉ áp dụng cho các seller đã chuyển đổi từ Tokopedia.Lưu ý:- Bạn cũng phải chỉ định một giá trị status khác ALL khi lọc theo nền tảng listing. Không hỗ trợ trả về tất cả các trạng thái.- Nếu bạn truyền vào một nền tảng, kết quả tìm kiếm sẽ trả về các sản phẩm được liệt kê trên nền tảng đó, bao gồm cả những sản phẩm được liệt kê trên cả hai nền tảng.- Nếu bạn truyền vào ["TIKTOK_SHOP", "TOKOPEDIA"], chỉ những sản phẩm được liệt kê trên cả hai nền tảng mới được trả về, không phải những sản phẩm chỉ được liệt kê trên một nền tảng. |
| audit_status | []string | Lọc sản phẩm theo trạng thái audit của chúng đối với TikTok Shop.Các giá trị có thể: - AUDITING: Trả về các sản phẩm có phiên bản gốc hoặc bản chỉnh sửa sau khi đăng đang được audit.- FAILED: Trả về các sản phẩm có phiên bản gốc hoặc bản chỉnh sửa sau khi đăng đã thất bại audit, hoặc đã bị hủy audit.- APPROVED: Trả về các sản phẩm đã vượt qua audit và đã được liệt kê trên nền tảng. |
| sku_ids | []string | Lọc sản phẩm theo SKU ID.Số lượng tối đa: 10 |
| sns_filter | string | Lọc sản phẩm theo trạng thái Subscribe and Save (SNS) của chúng. Các giá trị có thể:- CONFIGURED- ELIGIBLE |
| return_draft_version | bool | Lọc sản phẩm để chỉ hiển thị những sản phẩm có bản nháp.- true: Chỉ trả về các sản phẩm ở phiên bản nháp của chúng. Loại trừ những sản phẩm không có bản nháp.- false: Trả về tất cả sản phẩm bất kể chúng có bản nháp hay không.Mặc định: falseLưu ý: Chỉ áp dụng nếu bộ lọc trạng thái sản phẩm là ALL, DRAFT, ACTIVATE, SELLER_DEACTIVATED, hoặc PLATFORM_DEACTIVATED. |
| locale | string | Các mã locale BCP-47 để hiển thị thông tin danh mục.Mặc định: Locale mặc định của shop của bạn.Các giá trị có thể:- cs-CZ- de-AT- de-BE- de-DE- el-GR- en-GB- en-IE- en-US- es-ES- es-MX- fr-FR- fr-BE- hu-HU- id-ID- it-IT- ja-JP- ms-MY- nl-NL- nl-BE- pl-PL- pt-BR- pt-PT- th-TH- vi-VN- zh-CN |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | Mã trạng thái thành công hoặc thất bại được trả về trong API response. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong API response. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Log của request |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | 12019027 | The maximum count of “seller_skus” in the search filter is 10. | | 12019087 | The number of SKU IDs exceeds the limit of 10 | | 12019108 | page number is invalid | | 12019109 | page size is invalid | | 12019118 | search create time invalid | | 12019119 | search update time invalid | | 12052180 | The total number of search results can not exceed 10000. | | 12052700 | The seller is inactive. | | 12052704 | seller id not exist | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | | 12052910 | Invalid input parameters. Refer to the API documentation for details. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext