Douyin Promotable Video List (by Account)
omnial/douyin-douplus-fetch-promotable-item-list
Given a Douyin account's sec_uid, returns the video posts that account can promote through DOU+: one entry per video with its public caption, publish time, like/comment/share counts, and promotion eligibility flags (ad status, promotional status, enterprise-cart eligibility, post age). A sec_uid that does not resolve to a queryable account returns the endpoint's status code and message instead of a list.
Price
Up to $0.00205 per call; you pay what the call used
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.
Data source
Data from Douyin.
Use it
Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.
Connect once and your AI can find and run this tool, and any other it needs.
For developers: the calls your assistant makes
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/douyin-douplus-fetch-promotable-item-list" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/douyin-douplus-fetch-promotable-item-list" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/douyin-douplus-fetch-promotable-item-list", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/douyin-douplus-fetch-promotable-item-list", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.00205 |
- Updated
- Nov 6, 2026
Input and output schemas
Input schema
{
"type": "object",
"required": [
"sec_uid"
],
"properties": {
"count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 30,
"example": 30,
"description": "返回作品数量/Number of items"
},
"sec_uid": {
"type": "string",
"example": "MS4wLjABAAAA9fe7vGjwyiaOjL6REhX8rvmSb32VzA_XsKca9F3_YSHRXlEqgT2cpX54WGbtgnsA",
"description": "投放账号的 sec_uid/Delivery account sec_uid"
},
"target_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 31,
"example": 31,
"description": "推广目标(DOU+ 页面上的目标卡片)ID/Promotion target id (the goal card on the page). 31=点赞评论量, 32=粉丝量, 33=主页浏览量, 37=视频播放量, 40=直播间人气, 45=评论链接点击, 63=展示给粉丝, 78=高质量互动. 仅用于按推广目标筛选可投作品;只拉作品列表用默认 31 即可/Only filters promotable items by goal; keep 31 for a plain video list"
}
},
"additionalProperties": false
}Output schema
{
"type": "object",
"properties": {
"cursor": {
"type": "string",
"description": "List pagination marker; `0` on a not-found (error) response."
},
"has_more": {
"type": "number",
"description": "1 when more pages follow, 0 otherwise (0 on an error response)."
},
"status_msg": {
"type": "string",
"description": "Empty on a served list; the endpoint's error message (observed in Chinese) on an error response."
},
"status_code": {
"type": "number",
"description": "0 on a served list; a nonzero code (observed 301000) when the request could not be served."
},
"item_info_list": {
"type": "array",
"items": {
"type": "object",
"properties": {
"is_ad": {
"type": "boolean",
"description": "True when the post is an ad placement."
},
"aweme_info": {
"type": "object",
"properties": {
"desc": {
"type": "string",
"description": "The video's public caption text."
},
"author": {
"type": "object",
"properties": {
"sec_uid": {
"type": "string",
"description": "The account's sec_uid, echoing the requested input."
},
"nickname": {
"type": "string",
"description": "The account's public display name."
}
},
"description": "The account this promotable list belongs to -- the account named in the request.",
"additionalProperties": true
},
"aweme_id": {
"type": "string",
"description": "The video's numeric Douyin id."
},
"can_play": {
"type": "boolean",
"description": "Whether the video is currently playable."
},
"is_photo": {
"type": "boolean",
"description": "True when the post is a photo rather than a video."
},
"is_slides": {
"type": "boolean",
"description": "True when the post is a slideshow."
},
"statistics": {
"type": "object",
"properties": {
"digg_count": {
"type": "number",
"description": "Like count."
},
"share_count": {
"type": "number",
"description": "Share count."
},
"comment_count": {
"type": "number",
"description": "Comment count."
}
},
"description": "Public engagement counters for the video.",
"additionalProperties": true
},
"create_time": {
"type": "number",
"description": "Publish time, Unix milliseconds."
},
"is_daily_story": {
"type": "boolean",
"description": "True when the post is a daily story."
}
},
"description": "The video's own public record.",
"additionalProperties": true
},
"is_over_90_days": {
"type": "boolean",
"description": "True when the post is older than 90 days, a DOU+ eligibility factor."
},
"is_item_promotional": {
"type": "boolean",
"description": "True when the post is itself a product-promotional placement."
},
"douplus_user_post_tag": {
"type": [
"string",
"null"
],
"description": "A promotional tag label for unusually promotable posts; most posts carry none (null -- e.g. only 2 of 30 entries in one test had a tag)."
},
"item_can_mount_enterprise_cart": {
"type": "number",
"description": "Nonzero when the post can host an enterprise shopping cart, 0 otherwise."
}
},
"additionalProperties": true
},
"description": "One entry per promotable video. Absent entirely on an error response (e.g. a sec_uid that does not resolve) -- callers must not assume the array is always present."
}
},
"description": "The promotable-video list. Returned as `{ cursor, has_more, status_code, status_msg }` with NO `item_info_list` when the given `sec_uid` does not resolve to a queryable account.",
"additionalProperties": true
}