Skip to content
Eden Engine

Douyin Account Live Profile Lookup (by Short ID)

omnial/douyin-web-fetch-user-profile-by-short-id

Given a Douyin account short id, returns that account's public live profile: the account's own display name and permanent/sec ids, its attached live-room record (room id, status code, title, viewer count, and like count, when a room is present), and which live category/partition it streams under. An unresolvable short id returns an empty result at no charge rather than an error.

activeper callv1
Provider
Web & Business Data Network
Category
douyin
Provider price
$0.0020475 per call
Latency p50 / p95
— / —
Success rate
—
Verified
—

Provider list price; Omnial MCP charges provider cost plus a platform markup on top.

Contract

input_schema.json
{
  "type": "object",
  "required": [
    "short_id"
  ],
  "properties": {
    "short_id": {
      "type": "string",
      "examples": [
        "326528798"
      ],
      "description": "User Short ID"
    }
  },
  "additionalProperties": false
}
output_schema.json
{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "description": "The live room's broadcast title."
              },
              "id_str": {
                "type": "string",
                "description": "The live room's numeric id."
              },
              "status": {
                "type": "number",
                "description": "Live-room status code. Observed as 4 on the one real capture, where the room showed a title but zero viewers; what other codes mean is unconfirmed."
              },
              "like_count": {
                "type": "number",
                "description": "The room's like count."
              },
              "status_str": {
                "type": "string",
                "description": "The same live-room status code, as a string."
              },
              "mosaic_status": {
                "type": "number"
              },
              "live_room_mode": {
                "type": "number"
              },
              "user_count_str": {
                "type": "string",
                "description": "The room's reported viewer count as a string."
              },
              "mosaic_status_str": {
                "type": "string"
              },
              "has_commerce_goods": {
                "type": "boolean"
              }
            },
            "additionalProperties": true
          },
          "description": "The queried account's attached live-room detail, when one is present. Observed as a one-element array (the account's own room) on the one populated fixture; a multi-element observation was never captured, so only a single-room response is confirmed. Empty/absent when the account has no room attached."
        },
        "user": {
          "type": "object",
          "properties": {
            "id_str": {
              "type": "string",
              "description": "The account's permanent numeric id."
            },
            "sec_uid": {
              "type": "string",
              "description": "The account's permanent internal id string."
            },
            "nickname": {
              "type": "string",
              "description": "The account's public display name."
            },
            "open_id_str": {
              "type": "string",
              "description": "The account's open id string."
            },
            "avatar_thumb": {
              "type": "object",
              "properties": {
                "url_list": {
                  "type": "array",
                  "items": {
                    "type": "null"
                  },
                  "description": "The account's avatar image URLs. Every entry withheld (stripped to `null`) in this tool's output -- only whether the account has an avatar set is observable, not the image itself."
                }
              },
              "additionalProperties": true
            },
            "foreign_user": {
              "type": "number",
              "description": "Whether the account is a foreign/non-mainland account (0 or 1)."
            }
          },
          "description": "The queried account's own public identity.",
          "additionalProperties": true
        },
        "enter_mode": {
          "type": "number"
        },
        "room_status": {
          "type": "number",
          "description": "Overall live-room status code."
        },
        "enter_room_id": {
          "type": "string",
          "description": "The room id a viewer would enter -- equals the live room's own id."
        },
        "partition_road_map": {
          "type": "object",
          "properties": {
            "partition": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "number"
                },
                "title": {
                  "type": "string",
                  "description": "Category name, e.g. an entertainment label."
                },
                "id_str": {
                  "type": "string"
                }
              },
              "additionalProperties": true
            },
            "sub_partition": {
              "type": "object",
              "properties": {
                "partition": {
                  "type": "object",
                  "properties": {
                    "type": {
                      "type": "number"
                    },
                    "title": {
                      "type": "string",
                      "description": "Sub-category name."
                    },
                    "id_str": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": true
                }
              },
              "description": "A more specific sub-category, when assigned.",
              "additionalProperties": true
            }
          },
          "description": "The live category/partition the account streams under.",
          "additionalProperties": true
        }
      },
      "description": "The account's live-detail object. Absent (the whole shaped output is `{}`) on the not-found case.",
      "additionalProperties": true
    }
  },
  "description": "The account's live profile, as returned at routing.responseResultPath ($.output). Observed as `{}` (no other fields present) when the given `short_id` does not resolve to a live profile -- confirmed against the `user-profile-found` fixture, which still returned a completed run at $0 cost.",
  "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.

ChargeRate
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 25, 2026