POST Tìm kiếm Creator trên Marketplace dành cho Seller
Tìm kiếm Creator trên Marketplace dành cho Seller Shop Scope yêu cầu: seller.creator_marketplace.read API này được Seller sử dụng để tìm kiếm Creator trong Creator Marketplace. Seller có thể tìm kiếm dựa trên các bộ lọc như GMV, từ khóa và nhân khẩu học người theo dõi của Creator. Tất cả dữ liệu trả về là của 30 ngày gần nhất. Phiên bản 202508
POST/affiliate_seller/202508/marketplace_creators/search
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của seller lấy từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của seller. |
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 request API tới TTS, bạn phải ký chúng để TTS có thể xác định người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được dùng cho tất cả các request API. Nhà phát triển có thể dùng để chuyển đổi sang giờ địa phương. |
| page_token | string | Độ lệch phân trang xác định nơi bạn bắt đầu tìm kiếm. Giá trị này rỗng khi bạn gửi request đầu tiên |
| page_size Required | int | Giá trị của "page_size" phải là 12 hoặc 20 |
| 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 giá trị đúng 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 |
|---|---|---|
| search_key | string | Việc cache kết quả tìm kiếm giúp cải thiện hiệu năng api và đảm bảo kết quả request ổn định. Bạn không cần truyền giá trị trong lần gọi đầu tiên. Đối với lần gọi thứ hai, vui lòng truyền giá trị được trả về trong response của lần gọi đầu tiên. |
| keyword | string | Tìm kiếm creator theo từ khóa, đối sánh dựa trên TikTok Username và Nickname. |
| follower_demographics | object | Lọc creator theo nhân khẩu học người theo dõi |
| gmv_ranges | []string | Lọc theo các khoảng GMV bao gồm: GMV_RANGE_0_100: "0-100", GMV_RANGE_100_1000: "100-1000", GMV_RANGE_1000_10000: "1000-10000", GMV_RANGE_10000_AND_ABOVE: "10000+"Ví dụ: - Nếu truyền GMV_RANGE_0_100, nghĩa là lọc dữ liệu creator lớn hơn hoặc bằng 0 và nhỏ hơn hoặc bằng 100.- Nếu truyền GMV_RANGE_0_100 và GMV_RANGE_100_1000, nghĩa là lọc dữ liệu creator lớn hơn hoặc bằng 0 và nhỏ hơn hoặc bằng 1000. |
| units_sold_ranges | []string | Lọc theo các khoảng số lượng bán ra bao gồm: UNITS_SOLD_RANGE_0_10: "0-10", UNITS_SOLD_RANGE_10_100: "10-100", UNITS_SOLD_RANGE_100_1000: "100-1000", UNITS_SOLD_RANGE_1000_AND_ABOVE: "1000+"Ví dụ: - Nếu truyền UNITS_SOLD_RANGE_0_10, nghĩa là lọc dữ liệu creator lớn hơn hoặc bằng 0 và nhỏ hơn hoặc bằng 10.- Nếu truyền UNITS_SOLD_RANGE_0_10 và UNITS_SOLD_RANGE_10_100, nghĩa là lọc dữ liệu creator lớn hơn hoặc bằng 0 và nhỏ hơn hoặc bằng 100. |
| category | []object | Object cho các bộ lọc category: Get Categories |
| content_performance | object | Object chứa các bộ lọc hiệu suất nội dung |
| affiliate_data | object | Object chứa dữ liệu dựa trên affiliate |
| advanced_filters | object | Bộ lọc nâng cao đặc thù cho từng quốc gia. Chúng tôi sẽ cung cấp một endpoint riêng cho phép bạn truy vấn những bộ lọc nào khả dụng cho quốc gia nào. |
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 response API. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong response API. 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
Xem các mã lỗi phổ biến
| Code | Message | | --- | --- | | 45101004 | Đã đạt hạn mức truy vấn (10000 request mỗi ngày). Vui lòng thử lại vào ngày mai. | | 36009003 | Lỗi nội bộ. Vui lòng thử lại. Nếu sự cố vẫn tiếp diễn sau nhiều lần thử, vui lòng liên hệ bộ phận hỗ trợ nền tảng. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext