POST Creator Search Open Collaboration Product
Creator Search Open Collaboration Product Creator Scope bắt buộc: creator.affiliate_collaboration.read API này được dùng để tìm kiếm thông tin của các sản phẩm có open collaboration theo danh mục, tỷ lệ hoa hồng và từ khóa. Nó sẽ trả về tất cả các sản phẩm trên TikTok Shop Affiliate Product Marketplace đang ở trạng thái open collaboration. Creator chỉ có thể tìm kiếm open collaboration trong các khu vực mà họ đã đăng ký affiliate. Version 202405
POST/affiliate_creator/202405/open_collaborations/products/search
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được phép: application/json |
| x-tts-access-token Required | string | Giá trị creator access_token từ Get Access Token, khi user_type = 1. Làm theo hướng dẫn này để lấy creator 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 yêu cầu API tới 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 dùng trên tất cả các yêu cầu API. Nhà phát triển có thể dùng giá trị này để chuyển đổi sang giờ địa phương. |
| page_token | string | Offset phân trang xác định vị trí bạn bắt đầu tìm kiếm. Giá trị này rỗng khi bạn gửi yêu cầu đầu tiên. |
| page_size Required | int | Giá trị của "page_size" phải lớn hơn 0 và nhỏ hơn hoặc bằng 20. |
| sort_field | string | Kết quả trả về được sắp xếp theo trường được chỉ định. Các giá trị có thể:- commission_rate- product_sales_price- commission- units_soldChỉ định thứ tự sắp xếp bằng tham số sort_order. |
| sort_order | string | Thứ tự sắp xếp cho các đối tượng trong response. Mặc định: ASCCác giá trị có thể:- ASC: Thứ tự tăng dần- DESC: Thứ tự giảm dần |
Body
| Properties | Type | Description |
|---|---|---|
| title_keywords | []string | Danh sách từ khóa sản phẩm để tìm kiếm. Tiêu đề hoặc tên sản phẩm được khớp một cách lỏng lẻo. Các từ khóa trong danh sách tạo thành một truy vấn và tập kết quả các tên sản phẩm khớp được dựa trên toán tử liên kết AND giữa mỗi từ khóa. Ví dụ, danh sách từ khóa ["Men", "Fashion"] tạo một truy vấn "Men" AND "Fashion" và tập kết quả các tên sản phẩm khớp chứa sự kết hợp khớp lỏng lẻo của "Men" và "Fashion" như "Male Fashionable". Độ dài tối đa của danh sách là 20 từ khóa. Độ dài chuỗi từ khóa tối đa là 255 ký tự. |
| sales_price_range | object | Giới hạn các sản phẩm trong kết quả tìm kiếm ở những sản phẩm có giá lớn hơn hoặc bằng giá tối thiểu được biểu thị và nhỏ hơn giá tối đa được biểu thị. |
| category | object | Giới hạn các sản phẩm trong kết quả tìm kiếm ở những sản phẩm được liên kết với danh mục sản phẩm được biểu thị. |
| commission_rate_range | object | Tỷ lệ hoa hồng của sản phẩm được tìm kiếm cần được giới hạn trong khoảng này. |
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 | Request log |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | Empty. No business logic error codes. |
Is this content helpful?Helpful
Not Helpful
PreviousNext