Douyin Creator Series List (by User ID)
omnial/douyin-app-fetch-user-series-list
Given a Douyin creator's user id or sec user id, returns the list of short-drama/series shows published under that account: each series' id, title, synopsis, genre tags, episode count and watch progress, publish status, and whether it charges to unlock (and at what price). Also returns the creator's own public profile summary. An invalid or nonexistent user id returns an empty result rather than an error.
activeper callv2
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
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/douyin-app-fetch-user-series-list" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/douyin-app-fetch-user-series-list" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/douyin-app-fetch-user-series-list", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/douyin-app-fetch-user-series-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
input_schema.json
{
"type": "object",
"anyOf": [
{
"required": [
"user_id"
]
},
{
"required": [
"sec_user_id"
]
}
],
"properties": {
"cursor": {
"type": "integer",
"default": 0,
"description": "Cursor"
},
"user_id": {
"type": "string",
"examples": [
"3010877781453635"
],
"description": "User id"
},
"sec_user_id": {
"type": "string",
"examples": [
"MS4wLjABAAAAfAU5kMk-W4569G1z2iRsy8t6-kOxO17Eaz6yte4NQokeUeOpeqTGEc480e34O8lK"
],
"description": "User sec id"
}
},
"additionalProperties": false
}Output schema
output_schema.json
{
"type": "object",
"properties": {
"total": {
"type": "number",
"description": "Total number of series published by this creator."
},
"cursor": {
"type": "number",
"description": "Pass back as the `cursor` input to fetch the next page of series."
},
"has_more": {
"type": "number",
"description": "1 when more series remain beyond this page, 0 (or absent) otherwise."
},
"status_msg": {
"type": "string",
"description": "Empty string on success. A short, vendor-supplied error message (observed in Chinese) on a rejected request, e.g. an invalid user id."
},
"status_code": {
"type": "number",
"description": "0 on success; nonzero on a rejected request."
},
"series_infos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"desc": {
"type": "string",
"description": "Synopsis."
},
"stats": {
"type": "object",
"properties": {
"play_vv": {
"type": "number"
},
"collect_vv": {
"type": "number"
},
"total_episode": {
"type": "number"
},
"current_episode": {
"type": "number"
},
"updated_to_episode": {
"type": "number"
},
"last_added_item_time": {
"type": "number",
"description": "Unix seconds."
}
},
"additionalProperties": true
},
"actors": {
"type": "array",
"items": {},
"description": "Credited cast. Usually empty; item shape not documented."
},
"author": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"sec_uid": {
"type": "string"
},
"nickname": {
"type": "string",
"description": "The creator's own public display name."
},
"signature": {
"type": "string",
"description": "The creator's own public bio text."
},
"unique_id": {
"type": "string",
"description": "The creator's own public @handle. Empty string when not set."
},
"aweme_count": {
"type": "number"
},
"is_verified": {
"type": "boolean"
},
"avatar_thumb": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"url_list": {
"type": "array",
"items": {
"type": "null"
},
"description": "Each entry withheld (stripped to `null`) in this tool's output."
}
},
"description": "The creator's own avatar image. Value withheld (stripped to `null`) below.",
"additionalProperties": true
},
"custom_verify": {
"type": "string",
"description": "Verification badge text, when set."
},
"follower_count": {
"type": "number"
},
"following_count": {
"type": "number"
},
"total_favorited": {
"type": "number"
},
"favoriting_count": {
"type": "number"
}
},
"description": "The queried creator's own public profile summary. The same object is repeated on every series item, typically identical across all of them.",
"additionalProperties": true
},
"status": {
"type": "object",
"properties": {
"status": {
"type": "number",
"description": "Vendor status code, e.g. 2 for published."
},
"status_desc": {
"type": "string",
"description": "Human-readable status text when set, e.g. episode-count summary."
},
"is_collected": {
"type": "number"
}
},
"additionalProperties": true
},
"cover_url": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"url_list": {
"type": "array",
"items": {
"type": "null"
},
"description": "Each entry withheld (stripped to `null`) in this tool's output."
}
},
"description": "The series cover image. Value withheld (stripped to `null`) below.",
"additionalProperties": true
},
"directors": {
"type": "array",
"items": {},
"description": "Credited directors. Usually empty; item shape not documented."
},
"real_name": {
"type": "string",
"description": "An alternate/full title for the series -- typically identical to `series_name`. This is the show's own title, not a person's name."
},
"series_id": {
"type": "string"
},
"create_time": {
"type": "number",
"description": "Unix seconds."
},
"rights_info": {
"type": "object",
"properties": {
"has_paid": {
"type": "boolean"
}
},
"additionalProperties": true
},
"series_name": {
"type": "string",
"description": "The series' own published title."
},
"series_type": {
"type": "number"
},
"update_time": {
"type": "number",
"description": "Unix seconds."
},
"is_exclusive": {
"type": "boolean"
},
"dark_icon_url": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"url_list": {
"type": "array",
"items": {
"type": "null"
},
"description": "Each entry withheld (stripped to `null`) in this tool's output."
}
},
"description": "A dark-mode icon image. Value withheld (stripped to `null`) below.",
"additionalProperties": true
},
"light_icon_url": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"url_list": {
"type": "array",
"items": {
"type": "null"
},
"description": "Each entry withheld (stripped to `null`) in this tool's output."
}
},
"description": "A light-mode icon image. Value withheld (stripped to `null`) below.",
"additionalProperties": true
},
"charge_strategy": {
"type": "object",
"properties": {
"is_charge": {
"type": "number",
"description": "0 free, 1 charges."
},
"unit_price": {
"type": "number"
},
"total_price": {
"type": "number",
"description": "Vendor price units observed, e.g. 495."
},
"has_paid_episodes": {
"type": "number"
},
"discount_threshold": {
"type": "number"
},
"support_segment_unlock": {
"type": "boolean"
}
},
"description": "Whether/how the series charges to unlock episodes.",
"additionalProperties": true
},
"content_sub_type": {
"type": "number"
},
"is_charge_series": {
"type": "number",
"description": "Vendor status code for the series' paid/free state; values not documented."
},
"series_form_type": {
"type": "number"
},
"series_content_types_new": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Genre label, e.g. a romance/drama tag."
},
"series_content_type": {
"type": "number"
}
},
"additionalProperties": true
},
"description": "Genre/category tags for this series. Absent entirely (not present as a key) on series where the raw response returns `null` for this field."
}
},
"additionalProperties": true
},
"description": "One entry per published series. Absent entirely (not present as a key) on the not-found case, where the raw response returns `series_infos: null`."
}
},
"description": "The series list. `series_infos` is absent entirely (not `null`) when the given `user_id`/`sec_user_id` does not resolve to an existing account; such a call returns `status_code: 5` with a Chinese-language error message.",
"additionalProperties": true
}