# Douyin DOU+ estimated delivery results Get estimated delivery results for specified items, promotion target, budget and duration. Needs item ids. Served by TikHub. Purpose: - Get estimated delivery results for specified items, promotion target, budget and duration - Useful for comparing budget and duration options before creating a DOU+ order Parameters: - item_ids: Item id(s), comma separated (required). Normally use schema=0 for one item and schema=3 for multiple items - external_action: 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: 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: Delivery scene code. 0=single-item Default, 3=multi-item BatchDelivery; selected from the item count - is_max_cv: Whether to estimate in MaxCV (maximum-conversion-volume) mode; derived from target capability, item count, budget and manual-bid state by the official client - pay_type: Payment channel. 0=CashDesk, 1=IAP, 2=Caijing, 3=CgTradeCash; the official estimate request uses 1 - cost_int: Delivery budget in li (CNY 1/1000), default 30000 (CNY 30) - duration_seconds: Delivery duration in seconds, default 21600 (6 hours) Return: - Estimated delivery results for the selected budget, duration and promotion target - Tool ID: `tikhub/douyin-douplus-fetch-delivery-effect-estimate` - Name in the catalog: Douyin, Get DOU+ estimated delivery results - Provider: [TikHub](/providers/tikhub.md) - Capability: [DOU+ promotion data](/tools/douyin/douplus.md) - Price: price pending - Authentication: an authorised Agentik workspace is required for execution, including zero-price tools. ## Pricing contract No price is recorded for this tool yet. ```json { "model": "per_call", "amountUsd": 0 } ``` ## Complete input schema ```json { "type": "object", "properties": { "item_ids": { "type": "string", "minLength": 1, "title": "Item Ids", "description": "作品ID,多个用逗号分隔;单作品通常配合 schema=0,多作品配合 schema=3/Item id(s), comma separated; normally use schema=0 for one item and schema=3 for multiple items" }, "external_action": { "type": "integer", "title": "External Action", "description": "优化动作编码,需与 target_id 对应,默认44(NativeAction);常用:45=点赞,46=关注,47=评论,51=链接点击,102=多互动,181=主页访问/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", "default": 44 }, "target_id": { "type": "integer", "title": "Target Id", "description": "推广目标ID,默认31(点赞评论量);常用:32=粉丝量,33=主页访问,37=视频播放,40=直播间人气,45=评论链接点击,63=粉丝展示,78=自然流量提升,81=高互动频次/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", "default": 31 }, "schema": { "type": "integer", "title": "Schema", "description": "投放场景编码:0=单作品默认(Default),3=多作品批量投放(BatchDelivery);官方前端按 item_ids 数量选择/Delivery schema: 0=single-item Default, 3=multi-item BatchDelivery; the official client selects it from the item count", "default": 0 }, "is_max_cv": { "type": "boolean", "title": "Is Max Cv", "description": "是否使用MaxCV最大转化量模式预估;官方前端会根据优化目标能力、素材数量、预算及是否手动出价计算,默认true/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", "default": true }, "pay_type": { "type": "integer", "maximum": 3, "minimum": 0, "title": "Pay Type", "description": "支付通道类型:0=CashDesk,1=IAP,2=Caijing,3=CgTradeCash;官方预计效果调用固定传1/Payment channel: 0=CashDesk, 1=IAP, 2=Caijing, 3=CgTradeCash; the official estimate request uses 1", "default": 1 }, "cost_int": { "type": "integer", "exclusiveMinimum": 0, "title": "Cost Int", "description": "投放预算,单位为厘(人民币1/1000元),默认30000(30元)/Delivery budget in li (CNY 1/1000), default 30000 (CNY 30)", "default": 30000 }, "duration_seconds": { "type": "integer", "exclusiveMinimum": 0, "title": "Duration Seconds", "description": "投放时长,单位为秒,默认21600(6小时)/Delivery duration in seconds, default 21600 (6 hours)", "default": 21600 } }, "required": [ "item_ids" ], "additionalProperties": false } ``` ## Published example This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection. ```json { "tool_id": "tikhub/douyin-douplus-fetch-delivery-effect-estimate", "input": { "item_ids": "7677202522116819185", "external_action": 44, "target_id": 31, "schema": 0, "is_max_cv": true, "pay_type": 1, "cost_int": 30000, "duration_seconds": 21600 } } ``` ## Execute and retrieve Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative. A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md). [Provider documentation](https://api.tikhub.io/#/Douyin-DouPlus-API/fetch_delivery_effect_estimate_api_v1_douyin_douplus_fetch_delivery_effect_estimate_post) [REST inspection](https://api.agentik.cc/v1/tools/tikhub/douyin-douplus-fetch-delivery-effect-estimate) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md) --- [HTML page](/providers/tikhub/douyin-douplus-fetch-delivery-effect-estimate) · [Agent index](/llms.txt)