# Bilibili Huahuo LIVE creator search

Search live creators for branded-content or live-commerce collaborations. Takes nickname or mids, mids, is brand live and more, all optional. Served by TikHub.

Purpose:
- Search live creators for branded-content or live-commerce collaborations.
- Filter by creator attributes, audience demographics, live categories,
  performance, guild, primary commerce category, and GMV.

Parameters:
- `is_brand_live`: Live mode. Use `1` for branded-content live streams and
  `0` for commerce live streams.
- Branded-content mode supports popularity peak, hourly viewers, hourly
  comments, guild, and onboarding-status filters.
- Commerce mode supports primary category and 90-day GMV filters.
- `page`: One-based page number. Each page contains 20 records.

Returns:
- `total_count`: Total number of matching creators.
- `data`: Creator records containing profile, audience, live performance,
  and collaboration-capability metrics.

- Tool ID: `tikhub/bilibili-huahuo-search-live-upper`
- Name in the catalog: Bilibili, Search live creators
- Provider: [TikHub](/providers/tikhub.md)
- Capability: [Bilibili live](/tools/bilibili/live.md)
- Price: $0.01 per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


```json
{
  "model": "per_call",
  "amountUsd": 0.01
}
```

Pricing source: [https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info). Official per-success route price USD 0.01; daily upstream discounts may reduce provider cost. No discount invented for the customer. 10/second.

Price verification date: 2026-10-05.

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "nickname_or_mids": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Nickname Or Mids",
      "description": "按UP主昵称或UID搜索"
    },
    "mids": {
      "anyOf": [
        {
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Mids",
      "description": "按UID批量精确匹配"
    },
    "is_brand_live": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Is Brand Live",
      "description": "直播类型：1=内容直播 0=带货直播。两种类型可用的筛选项不同"
    },
    "gender": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Gender",
      "description": "主播性别"
    },
    "region_id": {
      "anyOf": [
        {
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Region Id",
      "description": "主播常驻地域（一级）"
    },
    "second_region_id": {
      "anyOf": [
        {
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Second Region Id",
      "description": "主播常驻地域（二级）"
    },
    "min_fans_num": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Min Fans Num",
      "description": "粉丝数下限"
    },
    "max_fans_num": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Fans Num",
      "description": "粉丝数上限"
    },
    "fans_gender_tag": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fans Gender Tag",
      "description": "粉丝性别标签"
    },
    "fans_age_tag": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fans Age Tag",
      "description": "粉丝年龄标签"
    },
    "fans_region_tag": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fans Region Tag",
      "description": "粉丝地域标签"
    },
    "live_subarea_id": {
      "anyOf": [
        {
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Live Subarea Id",
      "description": "直播分区（二级），取值见 live_area_list"
    },
    "partition_id": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Partition Id",
      "description": "投稿分区（一级）"
    },
    "second_partition_id": {
      "anyOf": [
        {
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Second Partition Id",
      "description": "投稿分区（二级）"
    },
    "min_popularity": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Min Popularity",
      "description": "近30天场均人气峰值下限"
    },
    "max_popularity": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Popularity",
      "description": "近30天场均人气峰值上限"
    },
    "live_audience_h_avg_30d_min": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Live Audience H Avg 30D Min",
      "description": "近30天时均观众数下限"
    },
    "live_audience_h_avg_30d_max": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Live Audience H Avg 30D Max",
      "description": "近30天时均观众数上限"
    },
    "live_danmu_h_avg_30d_min": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Live Danmu H Avg 30D Min",
      "description": "近30天时均弹幕数下限"
    },
    "live_danmu_h_avg_30d_max": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Live Danmu H Avg 30D Max",
      "description": "近30天时均弹幕数上限"
    },
    "live_guild_id": {
      "anyOf": [
        {
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Live Guild Id",
      "description": "直播公会，取值见 live_guild_drop"
    },
    "high_potential_type": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "High Potential Type",
      "description": "入驻状态"
    },
    "live_good_category": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Live Good Category",
      "description": "主营类目，0=全部，取值见 live_good_category"
    },
    "live_good_gmv": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Live Good Gmv",
      "description": "近90天GMV档位，0=全部"
    },
    "order_by": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Order By",
      "description": "排序字段"
    },
    "sort": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sort",
      "description": "排序方向：desc 或 asc"
    },
    "page": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1
        },
        {
          "type": "null"
        }
      ],
      "title": "Page",
      "description": "页码，从 1 开始，每页固定 20 条"
    }
  },
  "additionalProperties": false
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "tikhub/bilibili-huahuo-search-live-upper",
  "input": {}
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://api.tikhub.io/#/Bilibili-Huahuo-API/search_live_upper_api_v1_bilibili_huahuo_search_live_upper_post)

[REST inspection](https://api.agentik.cc/v1/tools/tikhub/bilibili-huahuo-search-live-upper) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/tikhub/bilibili-huahuo-search-live-upper) · [Agent index](/llms.txt)