Contract
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.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."
},
"gender": {
"type": "number",
"description": "Vendor-coded enum; meaning unconfirmed."
},
"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 on the one calibrated account (not live at capture time) -- a populated value was never 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 on the resolvable-account fixture, 10033 on the not-found fixture."
}
},
"description": "The response at routing.responseResultPath ($.output). 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, confirmed against the `invalid-sec-uid-not-found` fixture) and none of the profile fields -- a caller should check for the presence of `data.nickname` rather than assume the profile shape.",
"additionalProperties": true
}Pricing
Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.
Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.
| Charge | Rate |
|---|---|
Per call Flat, regardless of what comes back | $0.0020475 |
- Cost basis
- Not recorded
This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.
- Updated
- Sep 15, 2026