item_idsRequiredbody · string
Item id(s), comma separated; normally use schema=0 for one item and schema=3 for multiple items
POSTPrice pending
Fetch delivery effect estimate
Get DOU+ estimated delivery results
Endpoint
POST https://getvibeapi.com/v1/social/douyin/douplus/fetch_delivery_effect_estimateExample
curl -sS "https://getvibeapi.com/v1/social/douyin/douplus/fetch_delivery_effect_estimate" \
-H "Authorization: Bearer $GETVIBE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary '{"item_ids":"value"}'Send your key in the Authorization: Bearer header. You pay only for requests the data provider accepts. Requests it rejects (errors, timeouts, invalid parameters) are not billed. A valid request that returns an empty or not-found result from the platform is billed.
Parameters
external_actionbody · integer
Optimization action code; must match target_id, default 44 (NativeAction). Common values: 45=like, 46=follow, 47=comment, 51=link click, 102=multiple native actions, 181=homepage visit
target_idbody · integer
Promotion target id, default 31 (likes and comments). Common values: 32=followers, 33=homepage visits, 37=video plays, 40=live popularity, 45=comment-link clicks, 63=show to followers, 78=natural promotion, 81=high interaction frequency
schemabody · integer
Delivery schema: 0=single-item Default, 3=multi-item BatchDelivery; the official client selects it from the item count
is_max_cvbody · boolean
Whether to estimate in MaxCV (maximum-conversion-volume) mode; the official client derives it from target capability, item count, budget and manual-bid state, default true
pay_typebody · integer
Payment channel: 0=CashDesk, 1=IAP, 2=Caijing, 3=CgTradeCash; the official estimate request uses 1
cost_intbody · integer
Delivery budget in li (CNY 1/1000), default 30000 (CNY 30)
duration_secondsbody · integer
Delivery duration in seconds, default 21600 (6 hours)
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| item_ids | body | string | Yes | Item id(s), comma separated; normally use schema=0 for one item and schema=3 for multiple items |
| external_action | body | integer | No | Optimization action code; must match target_id, default 44 (NativeAction). Common values: 45=like, 46=follow, 47=comment, 51=link click, 102=multiple native actions, 181=homepage visit |
| target_id | body | integer | No | Promotion target id, default 31 (likes and comments). Common values: 32=followers, 33=homepage visits, 37=video plays, 40=live popularity, 45=comment-link clicks, 63=show to followers, 78=natural promotion, 81=high interaction frequency |
| schema | body | integer | No | Delivery schema: 0=single-item Default, 3=multi-item BatchDelivery; the official client selects it from the item count |
| is_max_cv | body | boolean | No | Whether to estimate in MaxCV (maximum-conversion-volume) mode; the official client derives it from target capability, item count, budget and manual-bid state, default true |
| pay_type | body | integer | No | Payment channel: 0=CashDesk, 1=IAP, 2=Caijing, 3=CgTradeCash; the official estimate request uses 1 |
| cost_int | body | integer | No | Delivery budget in li (CNY 1/1000), default 30000 (CNY 30) |
| duration_seconds | body | integer | No | Delivery duration in seconds, default 21600 (6 hours) |