Douyin Live Room Search (by Nickname or Douyin ID)

omnial/douyin-douplus-search-live-room

Given a Douyin nickname or Douyin ID (as a single `keyword`), returns a page of matching public accounts -- each with its nickname, handle, follower count, and current live-room status, including the room's title, room ID, and live/offline flag when that account is currently broadcasting. The endpoint matches loosely: an unrecognized or made-up keyword still returns a page of similarly-spelled accounts rather than an empty list.

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

Douyin

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.

Install it Create an account

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-douplus-search-live-room" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/douyin-douplus-search-live-room" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/douyin-douplus-search-live-room", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/douyin-douplus-search-live-room", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not 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: Oct 27, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "keyword"
  ],
  "properties": {
    "count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": 10,
      "example": 10,
      "description": "每页数量/Page size"
    },
    "cursor": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": 0,
      "example": 0,
      "description": "翻页游标,首页传 0,后续传上一页响应里的 cursor/Pagination cursor, 0 for first page"
    },
    "keyword": {
      "type": "string",
      "example": "小耳朵",
      "description": "抖音号 或 抖音昵称/Douyin ID or nickname"
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "msg": {
      "type": "string",
      "description": "e.g. 'success'."
    },
    "code": {
      "type": "number",
      "description": "0 on every real call observed."
    },
    "data": {
      "type": "object",
      "properties": {
        "cursor": {
          "type": "number",
          "description": "Pagination cursor to pass back in the next call's `cursor` input."
        },
        "hasMore": {
          "type": "boolean"
        },
        "userList": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "secUid": {
                "type": "string",
                "description": "An opaque platform identifier for the account."
              },
              "shortId": {
                "type": "string",
                "description": "The account's own public numeric short ID."
              },
              "nickname": {
                "type": "string",
                "description": "The account's own public display nickname."
              },
              "uniqueId": {
                "type": "string",
                "description": "The account's own public Douyin handle (its 'Douyin ID')."
              },
              "liveRoomInfo": {
                "type": "object",
                "properties": {
                  "LiveRoomInfoExtra": {
                    "type": "object",
                    "properties": {
                      "HasWindmill": {
                        "type": "boolean"
                      },
                      "IsForO2ORoom": {
                        "type": "boolean"
                      },
                      "HasBisinessComponent": {
                        "type": "boolean",
                        "description": "Vendor's own field name, spelled this way upstream."
                      },
                      "HasClosedShoppingCart": {
                        "type": "boolean"
                      }
                    },
                    "additionalProperties": true
                  },
                  "LiveRoomInfoDetail": {
                    "type": "object",
                    "properties": {
                      "Title": {
                        "type": "string",
                        "description": "The live room's title. Empty string when not currently live."
                      },
                      "RoomId": {
                        "type": "string",
                        "description": "'0' when the account is not currently live; a real room ID (e.g. '7681452107401628425') when it is."
                      },
                      "AnchorNickname": {
                        "type": "string",
                        "description": "The live room anchor's own public nickname. Typically identical to the account's `nickname`."
                      },
                      "LiveRoomCoverUri": {
                        "type": "string",
                        "description": "A relative asset path, not a fetchable URL -- it has no scheme or host and does not resolve on its own."
                      }
                    },
                    "additionalProperties": true
                  },
                  "LiveRoomLiveStatus": {
                    "type": "number",
                    "description": "0 = not currently live, 1 = currently live."
                  }
                },
                "additionalProperties": true
              },
              "followerCount": {
                "type": "number"
              },
              "followerCountStr": {
                "type": "string",
                "description": "Usually an empty string; it is not documented whether it is ever populated with a formatted count."
              }
            },
            "additionalProperties": true
          },
          "description": "The matching accounts. Observed as EMPTY only when `keyword` itself was empty -- a nonsense/unrecognized keyword still returned a full page of loosely-matched accounts, not an empty list."
        }
      },
      "additionalProperties": true
    }
  },
  "description": "The search result page.",
  "additionalProperties": true
}