Douyin User Live-Streaming Profile & Status (by Sec UID)
omnial/douyin-web-fetch-user-live-videos-by-sec-uid
Given a Douyin account's sec_uid, returns that account's live-streaming profile: nickname, verification status, follower/following counts, fan-club and badge/level standing, the account's live room id (when one exists), and gift-ticket counts. Despite the endpoint's name, no call has been observed to return a list of past broadcasts -- see usage.md.
activeper callv3
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-web-fetch-user-live-videos-by-sec-uid" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/douyin-web-fetch-user-live-videos-by-sec-uid" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/douyin-web-fetch-user-live-videos-by-sec-uid", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/douyin-web-fetch-user-live-videos-by-sec-uid", 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",
"required": [
"sec_uid"
],
"properties": {
"sec_uid": {
"type": "string",
"examples": [
"MS4wLjABAAAAAIKOBr_x6p2fPVKOAhqG8LrC1lwwdWChifKEsl-TXFS-kGSGqpMBRexJdzoAfvUF"
],
"description": "User sec_uid"
}
},
"additionalProperties": false
}Output schema
output_schema.json
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "number",
"description": "The account's numeric Douyin user id."
},
"city": {
"type": "string",
"description": "Self-disclosed city, when set."
},
"level": {
"type": "number",
"description": "General account level, distinct from pay_grade.level below."
},
"id_str": {
"type": "string",
"description": "The same id, as a string."
},
"status": {
"type": "number",
"description": "1 on the one resolvable account observed."
},
"message": {
"type": "string",
"description": "Only present on the not-found path, e.g. 'forbidden'."
},
"prompts": {
"type": "string",
"description": "Only present on the not-found path -- a human-readable (Chinese-language) reason the profile could not be viewed."
},
"sec_uid": {
"type": "string",
"description": "Echoes the queried sec_uid back."
},
"web_rid": {
"type": "string",
"description": "The account's live room id, populated while the account is actively broadcasting. Observed empty in testing (account not live at the time); a populated value has not been observed."
},
"nickname": {
"type": "string",
"description": "The account's public display name."
},
"short_id": {
"type": "number",
"description": "The account's public-facing Douyin short id (a numeric handle)."
},
"verified": {
"type": "boolean"
},
"fans_club": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"level": {
"type": "number"
},
"club_name": {
"type": "string",
"description": "Empty when the account has no fan club."
},
"user_fans_club_status": {
"type": "number"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"pay_grade": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Empty string observed at the one level seen."
},
"level": {
"type": "number"
},
"next_name": {
"type": "string"
}
},
"description": "The account's viewer/gifting grade standing inside live rooms.",
"additionalProperties": true
},
"signature": {
"type": "string",
"description": "The account's self-published bio text."
},
"display_id": {
"type": "string",
"description": "The same short id, as a string, as shown on the account's profile."
},
"follow_info": {
"type": "object",
"properties": {
"follow_status": {
"type": "number"
},
"follower_count": {
"type": "number"
},
"following_count": {
"type": "number"
},
"follower_count_str": {
"type": "string"
},
"following_count_str": {
"type": "string"
}
},
"additionalProperties": true
},
"webcast_uid": {
"type": "string",
"description": "An internal live-platform user id, distinct from `id`/`id_str`."
},
"avatar_large": {
"type": "object",
"properties": {
"url_list": {
"type": "array",
"items": {
"type": "null"
}
}
},
"additionalProperties": true
},
"avatar_thumb": {
"type": "object",
"properties": {
"url_list": {
"type": "array",
"items": {
"type": "null"
},
"description": "Withheld -- image URLs are not passed through, see usage.md."
}
},
"additionalProperties": true
},
"ticket_count": {
"type": "number"
},
"webcast_nick": {
"type": "string",
"description": "A live-room-specific display name, when set; empty otherwise."
},
"avatar_medium": {
"type": "object",
"properties": {
"url_list": {
"type": "array",
"items": {
"type": "null"
}
}
},
"additionalProperties": true
},
"location_city": {
"type": "string",
"description": "Same self-disclosed city, duplicated."
},
"link_mic_stats": {
"type": "number"
},
"verified_reason": {
"type": "string"
},
"badge_image_list": {
"type": "array",
"items": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"content": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"level": {
"type": "number"
},
"font_color": {
"type": "string"
},
"alternative_text": {
"type": "string",
"description": "e.g. a badge's tooltip text."
}
},
"additionalProperties": true
},
"url_list": {
"type": "array",
"items": {
"type": "null"
},
"description": "Withheld."
}
},
"additionalProperties": true
},
"description": "Honor-level badge icons; empty array observed as the not-live norm."
},
"fan_ticket_count": {
"type": "number"
},
"hotsoon_verified": {
"type": "boolean"
},
"verified_content": {
"type": "string"
},
"badge_image_list_v2": {
"type": "array",
"items": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"content": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"level": {
"type": "number"
},
"font_color": {
"type": "string"
},
"alternative_text": {
"type": "string"
}
},
"additionalProperties": true
},
"url_list": {
"type": "array",
"items": {
"type": "null"
},
"description": "Withheld."
}
},
"additionalProperties": true
},
"description": "A second, overlapping set of the same badge icons."
},
"hotsoon_verified_reason": {
"type": "string"
}
},
"additionalProperties": true
},
"status_code": {
"type": "number",
"description": "0 for a resolvable account, 10033 for an account that is not found."
}
},
"description": "The live-profile response. On a resolvable sec_uid, `data` carries the account's live-streaming profile fields below. On a sec_uid that does not resolve to a viewable account, `data` instead carries only `message`/`prompts` (a rejection reason) and none of the profile fields -- a caller should check for the presence of `data.nickname` rather than assume the profile shape.",
"additionalProperties": true
}