Skip to main content
POST
douyin fetch_delivery_effect_estimate
Get DOU+ estimated delivery results Pricing — billed per successful call; the final charge scales by your plan multiplier. Charged only when the upstream response body code is 200.
Response structure is not yet fully documented — refer to the actual API response.

Example

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

DOU+ Delivery Effect Estimate Request Model

item_ids
string
required

Item id(s), comma separated; normally use schema=0 for one item and schema=3 for multiple items

Minimum string length: 1
Example:

"7677202522116819185"

external_action
integer
default:44

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

Example:

44

target_id
integer
default:31

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

Example:

31

schema
integer
default:0

Delivery schema: 0=single-item Default, 3=multi-item BatchDelivery; the official client selects it from the item count

Example:

0

is_max_cv
boolean
default: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

Example:

true

pay_type
integer
default:1

Payment channel: 0=CashDesk, 1=IAP, 2=Caijing, 3=CgTradeCash; the official estimate request uses 1

Required range: 0 <= x <= 3
Example:

1

cost_int
integer
default:30000

1000), default 30000 (CNY 30

Example:

30000

duration_seconds
integer
default:21600

Delivery duration in seconds, default 21600 (6 hours

Example:

21600

Response

Successful response. The outer object follows ResponseModel; the endpoint-specific payload is in data.

Return

  • Estimated delivery results for the selected budget, duration and promotion target
code
integer
default:200

HTTP status code

request_id
string | null

Unique request identifier

message
string
default:Request successful. This request will incur a charge.

Response message (EN-US)

message_zh
string
default:请求成功,本次请求将被计费。

Response message (ZH-CN)

support
string
default:Discord: https://discord.gg/aMEAS8Xsvz

Support message

time
string

The time the response was generated

time_stamp
integer

The timestamp the response was generated

time_zone
string
default:America/Los_Angeles

The timezone of the response time

docs
string | null

Link to the API Swagger documentation for this endpoint

cache_message
string | null
default:This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.

Cache message (EN-US)

cache_message_zh
string | null
default:本次响应已缓存,可通过下方 URL 直接查看,有效期 24 小时,访问缓存链接无额外费用。缓存仅用于请求溯源,不影响接口数据的时效性,也不会再次通过接口返回。

Cache message (ZH-CN)

cache_url
string | null

The URL to access the cached result

router
string
default:""

The endpoint that generated this response

params
any
default:{}

The parameters used in the request

data
any

Endpoint-specific response payload. The official shared model does not declare a fixed type or field set. Use the operation's documented return fields or response example; an operation-specific schema, when present, describes the documented fields. Undocumented fields must be read from the actual response rather than assumed.