kolIdstringrequired
User kolId, can be obtained from the following interfaces: `douyin/xingtu/xingtu-kolid-by-uid`; `douyin/xingtu/xingtu-kolid-by-sec-user-id`; `douyin/xingtu/xingtu-kolid-by-unique-id`
https://api.sandbase.ai/v1/api/douyin/xingtu/kol-service-price-v1Get the XingTu rate card of a Douyin KOL: price per collaboration type (sponsored video, live and more), settlement type and industry tags.
[
{
"data": {
"activity_info": [],
"base_resp": {
"status_code": 0,
"status_message": "Success"
},
"hot_list_ranks": [],
"industry_tags": [
"3C及电器-个护健康电器",
"母婴宠物-宠物生活",
"生活服务-生活服务综合平台"
],
"price_info": [
{
"author_id": "7038603512770461703",
"desc": "植入视频",
"do_fold": false,
"enable": true,
"end_time": "2145916800",
"field": "long_video_price",
"is_open": true,
"need_price": true,
"online_status": 1,
"platform_source": 1,
"price": 13800,
"price_extra_info": {
"sku_version": 1
},
"settlement_desc": "固定价格",
"settlement_type": 2,
"start_time": "1787816883",
"task_category": 1,
"task_category_status": 1,
"template_list": [],
"video_type": 2
},
{
"author_id": "7038603512770461703",
"desc": "定制视频",
"do_fold": false,
"enable": true,
"end_time": "2145916800",
"field": "price",
"is_open": true,
"need_price": true,
"online_status": 1,
"platform_source": 1,
"price": 18500,
"price_extra_info": {
"sku_version": 1
},
"settlement_desc": "固定价格",
"settlement_type": 2,
"start_time": "1787816883",
"task_category": 1,
"task_category_status": 1,
"template_list": [],
"video_type": 71
},
{
"author_id": "7038603512770461703",
"desc": "按自然播放量结算",
"do_fold": true,
"enable": true,
"end_time": "2145916800",
"field": "price",
"is_open": true,
"need_price": true,
"online_status": 1,
"platform_source": 1,
"price": 20,
"price_extra_info": {
"ceiling_price": "16950",
"floor_price": "2260"
},
"settlement_desc": "按自然播放量结算",
"settlement_type": 30,
"start_time": "1714192481",
"task_category": 1,
"task_category_status": 1,
"template_list": [],
"video_type": 92
},
{
"author_id": "7038603512770461703",
"desc": "抖音短视频合集任务",
"do_fold": true,
"enable": true,
"end_time": "2145916800",
"field": "price",
"is_open": true,
"need_price": true,
"online_status": 1,
"platform_source": 1,
"price": 6500,
"settlement_desc": "固定价格",
"settlement_type": 2,
"start_time": "1698768000",
"task_category": 1,
"task_category_status": 1,
"template_list": [],
"video_type": 73
},
{
"author_id": "7038603512770461703",
"desc": "下载",
"enable": true,
"end_time": "2145916800",
"field": "price",
"is_open": true,
"need_price": true,
"online_status": 1,
"platform_source": 1,
"price": 300,
"settlement_desc": "固定价格",
"settlement_type": 2,
"start_time": "1665290941",
"task_category": 103,
"task_category_status": 1,
"template_list": [],
"video_type": 105
},
{
"author_id": "7038603512770461703",
"desc": "抖音短视频共创-参与达人",
"do_fold": true,
"enable": true,
"end_time": "2145916800",
"field": "price",
"is_open": true,
"need_price": true,
"online_status": 1,
"platform_source": 1,
"price": 5000,
"settlement_desc": "固定价格",
"settlement_type": 2,
"start_time": "1706716800",
"task_category": 1,
"task_category_status": 1,
"template_list": [],
"video_type": 91
}
]
}
}
]Select an example to load its inputs and result into the playground.
Pass a XingTu kolId and get the creator's published collaboration prices on XingTu, by task type.
curl -X POST "https://api.sandbase.ai/v1/api/douyin/xingtu/kol-service-price-v1" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"kolId": "7038603512770461703", "platformChannel": "_1"}'
| Name | Type | Required | Description |
|---|---|---|---|
kolId | string | Yes | User kolId, can be obtained from the following interfaces: douyin/xingtu/xingtu-kolid-by-uid; `douyin/xingtu/xingtu-k… |
platformChannel | string | Yes | Platform channel, supports the following parameters: _1: Douyin Video; _10: Douyin Live |
Real response for the request above, trimmed to the main fields. User names and long IDs are masked.
{
"industry_tags": [
"3C及电器-个护健康电器",
"母婴宠物-宠物生活",
"生活服务-生活服务综合平台"
],
"price_info": [
{
"desc": "植入视频",
"price": 13800,
"settlement_desc": "固定价格",
"task_category": 1,
"online_status": 1
},
{
"desc": "定制视频",
"price": 18500,
"settlement_desc": "固定价格",
"task_category": 1,
"online_status": 1
}
]
}
Flat price per call. Failed calls, including lookups whose target does not exist, are not charged.
Start building
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/douyin/xingtu/kol-service-price-v1" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"kolId": "7038603512770461703",
"platformChannel": "_1"
}
SANDBASE_JSON
)
printf '%s\n' "$result"Set your SandBase API key in your server environment. Requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep your key on the server. Do not expose it in browser code.
kolIdstringrequiredUser kolId, can be obtained from the following interfaces: `douyin/xingtu/xingtu-kolid-by-uid`; `douyin/xingtu/xingtu-kolid-by-sec-user-id`; `douyin/xingtu/xingtu-kolid-by-unique-id`
platformChannelstringrequiredPlatform channel, supports the following parameters: _1: Douyin Video; _10: Douyin Live
Saved example response for this API; no live request is made when viewing it.
[
{
"data": {
"activity_info": [],
"base_resp": {
"status_code": 0,
"status_message": "Success"
},
"hot_list_ranks": [],
"industry_tags": [
"3C及电器-个护健康电器",
"母婴宠物-宠物生活",
"生活服务-生活服务综合平台"
],
"price_info": [
{
"author_id": "7038603512770461703",
"desc": "植入视频",
"do_fold": false,
"enable": true,
"end_time": "2145916800",
"field": "long_video_price",
"is_open": true,
"need_price": true,
"online_status": 1,
"platform_source": 1,
"price": 13800,
"price_extra_info": {
"sku_version": 1
},
"settlement_desc": "固定价格",
"settlement_type": 2,
"start_time": "1787816883",
"task_category": 1,
"task_category_status": 1,
"template_list": [],
"video_type": 2
},
{
"author_id": "7038603512770461703",
"desc": "定制视频",
"do_fold": false,
"enable": true,
"end_time": "2145916800",
"field": "price",
"is_open": true,
"need_price": true,
"online_status": 1,
"platform_source": 1,
"price": 18500,
"price_extra_info": {
"sku_version": 1
},
"settlement_desc": "固定价格",
"settlement_type": 2,
"start_time": "1787816883",
"task_category": 1,
"task_category_status": 1,
"template_list": [],
"video_type": 71
},
{
"author_id": "7038603512770461703",
"desc": "按自然播放量结算",
"do_fold": true,
"enable": true,
"end_time": "2145916800",
"field": "price",
"is_open": true,
"need_price": true,
"online_status": 1,
"platform_source": 1,
"price": 20,
"price_extra_info": {
"ceiling_price": "16950",
"floor_price": "2260"
},
"settlement_desc": "按自然播放量结算",
"settlement_type": 30,
"start_time": "1714192481",
"task_category": 1,
"task_category_status": 1,
"template_list": [],
"video_type": 92
},
{
"author_id": "7038603512770461703",
"desc": "抖音短视频合集任务",
"do_fold": true,
"enable": true,
"end_time": "2145916800",
"field": "price",
"is_open": true,
"need_price": true,
"online_status": 1,
"platform_source": 1,
"price": 6500,
"settlement_desc": "固定价格",
"settlement_type": 2,
"start_time": "1698768000",
"task_category": 1,
"task_category_status": 1,
"template_list": [],
"video_type": 73
},
{
"author_id": "7038603512770461703",
"desc": "下载",
"enable": true,
"end_time": "2145916800",
"field": "price",
"is_open": true,
"need_price": true,
"online_status": 1,
"platform_source": 1,
"price": 300,
"settlement_desc": "固定价格",
"settlement_type": 2,
"start_time": "1665290941",
"task_category": 103,
"task_category_status": 1,
"template_list": [],
"video_type": 105
},
{
"author_id": "7038603512770461703",
"desc": "抖音短视频共创-参与达人",
"do_fold": true,
"enable": true,
"end_time": "2145916800",
"field": "price",
"is_open": true,
"need_price": true,
"online_status": 1,
"platform_source": 1,
"price": 5000,
"settlement_desc": "固定价格",
"settlement_type": 2,
"start_time": "1706716800",
"task_category": 1,
"task_category_status": 1,
"template_list": [],
"video_type": 91
}
]
}
}
]Explore more
| API | Price | Response |
|---|---|---|
Douyin XingTu KOL PriceThis API Douyin | $0.03 per call | JSON |
Douyin | $0.03 per call | JSON |
Douyin | $0.03 per call | JSON |
Douyin | $0.03 per call | JSON |
Douyin | $0.03 per call | JSON |
Douyin | $0.03 per call | JSON |
Questions
Send a POST request to https://api.sandbase.ai/v1/api/douyin/xingtu/kol-service-price-v1 with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.
$0.03 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.
Required: kolId (string) and platformChannel (string). The Parameters table and the Playground on this page list every field.
A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.
No. Douyin XingTu KOL Price runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Douyin API access separately.