curl --request POST \
--url https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_upper \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"label_array": [
[
794,
747,
748
]
],
"page": 1
}
'{
"cache_message": "This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.",
"cache_message_zh": "本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。",
"cache_url": "<string>",
"code": 200,
"data": "<unknown>",
"docs": "<string>",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功，本次请求将被计费。",
"params": {},
"request_id": "<string>",
"router": "",
"support": "Discord: https://discord.gg/aMEAS8Xsvz",
"time": "<string>",
"time_stamp": 123,
"time_zone": "America/Los_Angeles"
}商业
bilibili search_upper
UP主广场搜索（搜UP主
POST
https://api.aisa.one
/
apis
/
v1
/
tikhub
/
bilibili
/
huahuo
/
search_upper
curl --request POST \
--url https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_upper \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"label_array": [
[
794,
747,
748
]
],
"page": 1
}
'{
"cache_message": "This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.",
"cache_message_zh": "本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。",
"cache_url": "<string>",
"code": 200,
"data": "<unknown>",
"docs": "<string>",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功，本次请求将被计费。",
"params": {},
"request_id": "<string>",
"router": "",
"support": "Discord: https://discord.gg/aMEAS8Xsvz",
"time": "<string>",
"time_stamp": 123,
"time_zone": "America/Los_Angeles"
}UP主广场搜索（搜UP主
计费 — 按成功调用计费，最终扣费按你的套餐倍率浮动。仅当上游响应体
code 为 200 时计费。
示例
curl -X POST "https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_upper" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{}' # 请求体结构见下方 schema
请求规范
- 方法与路径: POST /apis/v1/tikhub/bilibili/huahuo/search_upper
- 可用状态: enabled
- 请求 URL 模板:
https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_upper - Runtime 事实版本: 85ae03121f63417c9ff9d57a0fd59fdc6386fd71e2dc732a002843e6d8979d87
{
"operationId": "post_tikhub_bilibili_huahuo_search_upper",
"method": "POST",
"path": "/apis/v1/tikhub/bilibili/huahuo/search_upper",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [],
"security": [
{
"bearerAuth": []
}
],
"requestBody": {
"content": {
"application/json": {
"examples": {
"content_type_multiple": {
"description": "Select Outdoor Adventure (794), AI Short Film (747), and AI Funny Video (748) simultaneously; all values are in the same inner array.",
"summary": "Multiple content types",
"value": {
"label_array": [
[
794,
747,
748
]
],
"page": 1
}
},
"content_type_single": {
"description": "Select Outdoor Travel > Outdoor Adventure (upper_label_tree value=794).",
"summary": "Single content type",
"value": {
"label_array": [
[
794
]
],
"page": 1
}
},
"cooperation_experience_multiple_industries": {
"description": "Cooperation count set to \"Extensive experience\", with all selected industry IDs for Real Estate, Furniture, and Bathroom Products passed hierarchically.",
"summary": "Extensive multi-industry experience",
"value": {
"huahuo_first_industry_ids": [
"388",
"405"
],
"huahuo_second_industry_ids": [
"389",
"393",
"399",
"401",
"403",
"406",
"411"
],
"huahuo_third_industry_ids": [
"390",
"394",
"395",
"396",
"398",
"400",
"402",
"404",
"407",
"408",
"409",
"410",
"413"
],
"page": 1,
"panel_type": 0,
"spark_tag": [
"coo_frequent"
]
}
},
"cooperation_experience_multiple_industries_experienced": {
"description": "Cooperation count set to \"Has cooperation experience\", with all selected industry IDs for Real Estate, Furniture, and Bathroom Products passed hierarchically.",
"summary": "Multiple-industry cooperation experience",
"value": {
"huahuo_first_industry_ids": [
"388",
"405"
],
"huahuo_second_industry_ids": [
"389",
"393",
"399",
"401",
"403",
"406",
"411"
],
"huahuo_third_industry_ids": [
"390",
"394",
"395",
"396",
"398",
"400",
"402",
"404",
"407",
"408",
"409",
"410",
"413"
],
"page": 1,
"panel_type": 0,
"spark_tag": [
"cooperate"
]
}
},
"cooperation_experience_real_estate": {
"description": "Cooperation count set to \"Has cooperation experience\", cooperation industry set to \"Real Estate / All\".",
"summary": "Real-estate cooperation experience",
"value": {
"huahuo_first_industry_ids": [
"388"
],
"huahuo_second_industry_ids": [
"389",
"393",
"399",
"401",
"403"
],
"huahuo_third_industry_ids": [
"390",
"394",
"395",
"396",
"398",
"400",
"402",
"404"
],
"page": 1,
"panel_type": 0,
"spark_tag": [
"cooperate"
]
}
},
"cooperation_pricing_custom_podcast": {
"description": "Custom podcast series, starting at 100,000 CNY, including licensing for derivative content/distribution.",
"summary": "Custom-podcast pricing",
"value": {
"page": 1,
"price_info": [
{
"cooperation_type": 23,
"creative_skill": [],
"include_content": [
1
],
"price_max": "",
"price_min": 100000,
"price_right": []
}
]
}
},
"cooperation_pricing_deep_custom": {
"description": "Over 100,000 RMB; includes licensed derivative creation/distribution, complimentary trailer, and custom content; creation skills selected: overseas filming, in-depth technical analysis, short film/micro-movie.",
"summary": "Deep-custom pricing",
"value": {
"page": 1,
"price_info": [
{
"cooperation_type": 22,
"creative_skill": [
1,
2,
3
],
"include_content": [
1,
2,
3
],
"price_max": "",
"price_min": 100000,
"price_right": []
}
]
}
},
"cooperation_pricing_direct_post": {
"description": "Direct-post pricing 100,000 RMB or above; pass empty arrays for unavailable array fields.",
"summary": "Direct-post pricing",
"value": {
"page": 1,
"price_info": [
{
"cooperation_type": 3,
"creative_skill": [],
"include_content": [],
"price_max": "",
"price_min": 100000,
"price_right": []
}
]
}
},
"cooperation_pricing_embedded_video": {
"description": "Embedded-video pricing 100,000 RMB or above; pass empty arrays for unavailable creative skills and included content.",
"summary": "Embedded-video pricing",
"value": {
"page": 1,
"price_info": [
{
"cooperation_type": 1,
"creative_skill": [],
"include_content": [],
"price_max": "",
"price_min": 100000,
"price_right": []
}
]
}
},
"median_views": {
"description": "300,000 to 500,000, organic traffic scope, last 15 days; pass range as a string.",
"summary": "Median views",
"value": {
"max_play_median": "500000",
"min_play_median": "300000",
"page": 1,
"play_median_cycle": 2,
"play_median_traffic_type": 2
}
},
"median_views_default_scope": {
"description": "500,000 to 1,000,000, all traffic scope, last 30 days; pass range as a string.",
"summary": "Median views from 500K to 1M",
"value": {
"max_play_median": "1000000",
"min_play_median": "500000",
"page": 1,
"play_median_cycle": 3,
"play_median_traffic_type": 1
}
},
"residence_regions_multiple": {
"description": "Select Beijing (4), Shanghai (5), Fujian (23), and within Fujian: Xiamen (51) and Fuzhou (50).",
"summary": "Multiple residence regions",
"value": {
"page": 1,
"region_id": [
4,
5,
23
],
"second_region_id": [
51,
50
]
}
},
"video_honors_multiple": {
"description": "Hot or site-wide chart honor awarded twice in the last 90 days.",
"summary": "Multiple video honors",
"value": {
"av_honor": {
"honor_count": 2,
"honor_type": [
"HOT",
"QZPHB"
],
"time_period": 90
},
"page": 1
}
},
"video_honors_single": {
"description": "Hot honor awarded once in the last 30 days.",
"summary": "Single video honor",
"value": {
"av_honor": {
"honor_count": 1,
"honor_type": [
"HOT"
],
"time_period": 30
},
"page": 1
}
}
},
"schema": {
"additionalProperties": true,
"description": "### Search modes:\n- `nickname_or_mids`: Search by creator nickname or UID; separate multiple\n terms with commas.\n- `main_search`: Search by content keyword and include matched videos in\n the response.\n- `mids` / `upper_mid`: Match one or more creator UIDs exactly.\n\n### Filter groups:\n- **Profile and affiliation**: gender, followers, region, content category,\n MCN, service provider, and account type.\n- **Audience profile**: age, gender, region affinity, and follower loyalty.\n- **Pricing and performance**: quote, engagement rate, median views, CPM,\n CPC, CPE, and store-entry cost.\n- **Content and cooperation**: post count, viral-post ratio, video duration,\n honors, industries, and cooperation experience.\n- **Commerce**: permission, level, categories, GPM, component CTR, and\n average product price.\n- **Audience packages and labels**: DMP packages, feature tags, content-type\n trees, and high-potential tags.\n\nEvery field is optional. Send ratio fields as decimal values (for example,\n`0.05` for 5%) and monetary fields as the RMB values displayed by Huahuo.\nDynamic IDs are available from `square_static_info`, `upper_label_tree`,\nand the corresponding dropdown endpoints.\n\n# [Example]\n```json\n{\n \"nickname_or_mids\": \"2233,xiaodianshi\",\n \"marketing_target\": 1,\n \"panel_type\": 0,\n \"min_fans_num\": 100000,\n \"max_fans_num\": 1000000,\n \"min_interact_rate\": 0.03,\n \"play_median_traffic_type\": 1,\n \"play_median_cycle\": 3,\n \"price_info\": [{\n \"cooperation_type\": 1,\n \"creative_skill\": [],\n \"include_content\": [],\n \"price_min\": 1000,\n \"price_max\": 10000,\n \"price_right\": []\n }],\n \"goods_ctr_type\": 1,\n \"page\": 1\n}\n```\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`); `upper_label_tree` = `GET /tikhub/bilibili/huahuo/upper_label_tree` (operationId: `get_tikhub_bilibili_huahuo_upper_label_tree`).",
"properties": {
"av_active": {
"description": "Recent-publishing activity switch: 1=enabled, 0=all",
"title": "Av Active",
"type": [
"integer",
"null"
]
},
"av_active_tag": {
"description": "Recent-publishing activity tier from av_active_tag returned by /tikhub/bilibili/huahuo/square_static_info\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).",
"title": "Av Active Tag",
"type": [
"string",
"null"
]
},
"av_honor": {
"anyOf": [
{
"allOf": [
{
"additionalProperties": true,
"description": "Creator video-honor filter.",
"properties": {
"honor_count": {
"description": "Honor count: 0=all, 1=once, 2=twice, 3=three or more",
"title": "Honor Count",
"type": [
"integer",
"null"
]
},
"honor_type": {
"description": "Multi-select honor types: HOT, MZBK, and QZPHB",
"items": {
"type": "string"
},
"title": "Honor Type",
"type": [
"array",
"null"
]
},
"time_period": {
"description": "Time period: 0=all, or the most recent 30, 90, or 180 days",
"title": "Time Period",
"type": [
"integer",
"null"
]
}
},
"title": "UpperHonorFilter",
"type": "object"
}
],
"description": "Video honors have no separate options endpoint; use the search_upper documentation and always send honor_type as an array\n\nAPI references: `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`)."
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Video honors have no separate options endpoint; use the search_upper documentation and always send honor_type as an array\n\nAPI references: `search_upper` = `POST /tikhub/bilibili/huahuo/search_upper` (operationId: `post_tikhub_bilibili_huahuo_search_upper`)."
},
"bdata_tag_lv5": {
"description": "Bilibili level-five content-tag filter values",
"items": {},
"title": "Bdata Tag Lv5",
"type": [
"array",
"null"
]
},
"blue_url_click_cost_gte": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Minimum blue-link click cost, cooperation and promotion spend divided by clicks",
"title": "Blue Url Click Cost Gte"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Minimum blue-link click cost, cooperation and promotion spend divided by clicks",
"title": "Blue Url Click Cost Gte"
},
"blue_url_click_cost_lt": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Maximum blue-link click cost, cooperation and promotion spend divided by clicks",
"title": "Blue Url Click Cost Lt"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Maximum blue-link click cost, cooperation and promotion spend divided by clicks",
"title": "Blue Url Click Cost Lt"
},
"blue_url_ctr_gte": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Minimum blue-link CTR, blue-link clicks divided by video views",
"title": "Blue Url Ctr Gte"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Minimum blue-link CTR, blue-link clicks divided by video views",
"title": "Blue Url Ctr Gte"
},
"blue_url_ctr_lt": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Maximum blue-link CTR, blue-link clicks divided by video views",
"title": "Blue Url Ctr Lt"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Maximum blue-link CTR, blue-link clicks divided by video views",
"title": "Blue Url Ctr Lt"
},
"category_dmp_group_id": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "Content-category DMP audience-package ID",
"title": "Category Dmp Group Id"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Content-category DMP audience-package ID",
"title": "Category Dmp Group Id"
},
"category_dmp_label": {
"description": "Display label for the content-category DMP audience package",
"title": "Category Dmp Label",
"type": [
"string",
"null"
]
},
"cooperate_experience_industry_ids": {
"description": "For non-general panels, call /tikhub/bilibili/huahuo/cooperate_experience_industry first and put selected IDs here; unused by the general panel\n\nAPI references: `cooperate_experience_industry` = `GET /tikhub/bilibili/huahuo/cooperate_experience_industry` (operationId: `get_tikhub_bilibili_huahuo_cooperate_experience_industry`).",
"items": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
},
"title": "Cooperate Experience Industry Ids",
"type": [
"array",
"null"
]
},
"cooperate_experience_type": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "Experience type for non-general strategy panels: 1=experienced, 2=extensive, 3=none in current industry, 4=experience in other industries; use 1 or 2 with selected industries, while the general panel uses spark_tag",
"title": "Cooperate Experience Type"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Experience type for non-general strategy panels: 1=experienced, 2=extensive, 3=none in current industry, 4=experience in other industries; use 1 or 2 with selected industries, while the general panel uses spark_tag",
"title": "Cooperate Experience Type"
},
"cpc_cycle": {
"description": "CPC window: 1=7 days, 2=15 days, 3=30 days",
"title": "Cpc Cycle",
"type": [
"integer",
"null"
]
},
"cpc_traffic_type": {
"description": "CPC traffic scope: 1=all traffic, 2=organic traffic",
"title": "Cpc Traffic Type",
"type": [
"integer",
"null"
]
},
"cpe_cycle": {
"description": "CPE window: 1=7 days, 3=30 days",
"title": "Cpe Cycle",
"type": [
"integer",
"null"
]
},
"cpe_gte": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Minimum CPE, calculated as spend divided by valid engagements",
"title": "Cpe Gte"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Minimum CPE, calculated as spend divided by valid engagements",
"title": "Cpe Gte"
},
"cpe_lt": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Maximum CPE, calculated as spend divided by valid engagements",
"title": "Cpe Lt"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Maximum CPE, calculated as spend divided by valid engagements",
"title": "Cpe Lt"
},
"cpe_traffic_type": {
"description": "CPE traffic scope: 1=all traffic, 2=organic traffic",
"title": "Cpe Traffic Type",
"type": [
"integer",
"null"
]
},
"cpm_cycle": {
"description": "CPM window: 1=7 days, 2=15 days, 3=30 days",
"title": "Cpm Cycle",
"type": [
"integer",
"null"
]
},
"cpm_type": {
"description": "CPM traffic scope: 1=all traffic, 2=organic traffic",
"title": "Cpm Type",
"type": [
"integer",
"null"
]
},
"custom_video_pricing_set": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "Whether custom-video pricing has been configured\n\nUsage: Require configured custom-video pricing;\n `is_x_plan_better_up`: X Plan preferred creators.",
"title": "Custom Video Pricing Set"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Whether custom-video pricing has been configured\n\nUsage: Require configured custom-video pricing;\n `is_x_plan_better_up`: X Plan preferred creators.",
"title": "Custom Video Pricing Set"
},
"dmp_group_id": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "DMP custom audience-package ID from /tikhub/bilibili/huahuo/dmp_pkg_list\n\nAPI references: `dmp_pkg_list` = `GET /tikhub/bilibili/huahuo/dmp_pkg_list` (operationId: `get_tikhub_bilibili_huahuo_dmp_pkg_list`).",
"title": "Dmp Group Id"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "DMP custom audience-package ID from /tikhub/bilibili/huahuo/dmp_pkg_list\n\nAPI references: `dmp_pkg_list` = `GET /tikhub/bilibili/huahuo/dmp_pkg_list` (operationId: `get_tikhub_bilibili_huahuo_dmp_pkg_list`).",
"title": "Dmp Group Id"
},
"dmp_pkg_effect_rate_gte": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Minimum DMP influence: recent matching viewers divided by the audience population",
"title": "Dmp Pkg Effect Rate Gte"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Minimum DMP influence: recent matching viewers divided by the audience population",
"title": "Dmp Pkg Effect Rate Gte"
},
"dmp_pkg_effect_rate_lte": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Maximum DMP influence: recent matching viewers divided by the audience population",
"title": "Dmp Pkg Effect Rate Lte"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Maximum DMP influence: recent matching viewers divided by the audience population",
"title": "Dmp Pkg Effect Rate Lte"
},
"dmp_pkg_fan_rate_gte": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Minimum DMP attention: matching audience members divided by all followers",
"title": "Dmp Pkg Fan Rate Gte"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Minimum DMP attention: matching audience members divided by all followers",
"title": "Dmp Pkg Fan Rate Gte"
},
"dmp_pkg_fan_rate_lte": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Maximum DMP attention: matching audience members divided by all followers",
"title": "Dmp Pkg Fan Rate Lte"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Maximum DMP attention: matching audience members divided by all followers",
"title": "Dmp Pkg Fan Rate Lte"
},
"dmp_pkg_name": {
"description": "DMP special-audience package name query",
"title": "Dmp Pkg Name",
"type": [
"string",
"null"
]
},
"dmp_pkg_vertical_rate_gte": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Minimum DMP verticality: matching videos divided by all videos",
"title": "Dmp Pkg Vertical Rate Gte"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Minimum DMP verticality: matching videos divided by all videos",
"title": "Dmp Pkg Vertical Rate Gte"
},
"dmp_pkg_vertical_rate_lte": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Maximum DMP verticality: matching videos divided by all videos",
"title": "Dmp Pkg Vertical Rate Lte"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Maximum DMP verticality: matching videos divided by all videos",
"title": "Dmp Pkg Vertical Rate Lte"
},
"draft_duration": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "Dominant video duration: 1=0-30s, 2=30-60s, 3=1-3min, 4=3-5min, 5=5-10min, 6=over 10min",
"title": "Draft Duration"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Dominant video duration: 1=0-30s, 2=30-60s, 3=1-3min, 4=3-5min, 5=5-10min, 6=over 10min",
"title": "Draft Duration"
},
"entry_cost_max": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Maximum store-entry cost for relevant cooperation in the last year",
"title": "Entry Cost Max"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Maximum store-entry cost for relevant cooperation in the last year",
"title": "Entry Cost Max"
},
"entry_cost_min": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Minimum store-entry cost for relevant cooperation in the last year",
"title": "Entry Cost Min"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Minimum store-entry cost for relevant cooperation in the last year",
"title": "Entry Cost Min"
},
"fans_age_tag": {
"description": "Audience age-affinity tags from /tikhub/bilibili/huahuo/square_static_info\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).",
"items": {
"type": "string"
},
"title": "Fans Age Tag",
"type": [
"array",
"null"
]
},
"fans_gender_tag": {
"description": "Audience gender-affinity tags from /tikhub/bilibili/huahuo/square_static_info\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).",
"items": {
"type": "string"
},
"title": "Fans Gender Tag",
"type": [
"array",
"null"
]
},
"fans_region_tag": {
"description": "Audience region-affinity tags from /tikhub/bilibili/huahuo/square_static_info\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).",
"items": {
"type": "string"
},
"title": "Fans Region Tag",
"type": [
"array",
"null"
]
},
"fans_stick": {
"description": "Follower-loyalty filter: 0 means unrestricted; obtain other values from the static filter options.",
"title": "Fans Stick",
"type": [
"integer",
"null"
]
},
"folder_id": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "Saved-creator folder ID used to limit the search",
"title": "Folder Id"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Saved-creator folder ID used to limit the search",
"title": "Folder Id"
},
"gender": {
"description": "Creator gender from gender_info returned by /tikhub/bilibili/huahuo/square_static_info\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).",
"title": "Gender",
"type": [
"string",
"null"
]
},
"goods_avg_price_max": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Maximum average product price in the last 30 days, in RMB",
"title": "Goods Avg Price Max"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Maximum average product price in the last 30 days, in RMB",
"title": "Goods Avg Price Max"
},
"goods_avg_price_min": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Minimum average product price in the last 30 days, in RMB",
"title": "Goods Avg Price Min"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Minimum average product price in the last 30 days, in RMB",
"title": "Goods Avg Price Min"
},
"goods_category_first_ids": {
"description": "Primary commerce-category IDs from /tikhub/bilibili/huahuo/effect_goods_drop\n\nAPI references: `effect_goods_drop` = `GET /tikhub/bilibili/huahuo/effect_goods_drop` (operationId: `get_tikhub_bilibili_huahuo_effect_goods_drop`).",
"items": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
},
"title": "Goods Category First Ids",
"type": [
"array",
"null"
]
},
"goods_category_second_ids": {
"description": "Secondary commerce-category IDs from /tikhub/bilibili/huahuo/effect_goods_drop\n\nAPI references: `effect_goods_drop` = `GET /tikhub/bilibili/huahuo/effect_goods_drop` (operationId: `get_tikhub_bilibili_huahuo_effect_goods_drop`).",
"items": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
},
"title": "Goods Category Second Ids",
"type": [
"array",
"null"
]
},
"goods_ctr_max": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Maximum commerce-component CTR, clicks divided by impressions",
"title": "Goods Ctr Max"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Maximum commerce-component CTR, clicks divided by impressions",
"title": "Goods Ctr Max"
},
"goods_ctr_min": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Minimum commerce-component CTR, clicks divided by impressions",
"title": "Goods Ctr Min"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Minimum commerce-component CTR, clicks divided by impressions",
"title": "Goods Ctr Min"
},
"goods_ctr_type": {
"description": "Commerce CTR component scope: 1=all components, 2=comment component",
"title": "Goods Ctr Type",
"type": [
"integer",
"null"
]
},
"goods_gpm_max": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Maximum 30-day GPM, paid GMV per 1,000 commerce-video views",
"title": "Goods Gpm Max"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Maximum 30-day GPM, paid GMV per 1,000 commerce-video views",
"title": "Goods Gpm Max"
},
"goods_gpm_min": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Minimum 30-day GPM, paid GMV per 1,000 commerce-video views",
"title": "Goods Gpm Min"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Minimum 30-day GPM, paid GMV per 1,000 commerce-video views",
"title": "Goods Gpm Min"
},
"goods_is_high_fans_play_permeate": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "High follower-view penetration filter",
"title": "Goods Is High Fans Play Permeate"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "High follower-view penetration filter",
"title": "Goods Is High Fans Play Permeate"
},
"goods_is_high_video_play_permeate": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "High video-view penetration filter, top 20% by recent viewers per follower",
"title": "Goods Is High Video Play Permeate"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "High video-view penetration filter, top 20% by recent viewers per follower",
"title": "Goods Is High Video Play Permeate"
},
"goods_permission": {
"description": "Commerce permission filter: 1=required, 0=all",
"title": "Goods Permission",
"type": [
"integer",
"null"
]
},
"goods_up_levels": {
"description": "Commerce-creator level values",
"items": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
},
"title": "Goods Up Levels",
"type": [
"array",
"null"
]
},
"half_max_hot_avid_cnt": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "Maximum viral-video count in the last six months",
"title": "Half Max Hot Avid Cnt"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Maximum viral-video count in the last six months",
"title": "Half Max Hot Avid Cnt"
},
"half_min_hot_avid_cnt": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "Minimum viral-video count in the last six months",
"title": "Half Min Hot Avid Cnt"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Minimum viral-video count in the last six months",
"title": "Half Min Hot Avid Cnt"
},
"high_potential_type": {
"description": "High-potential type: 0=all, 1=onboarded, 2=not onboarded",
"title": "High Potential Type",
"type": [
"integer",
"null"
]
},
"huahuo_first_industry_ids": {
"description": "For the general panel, call /tikhub/bilibili/huahuo/square_static_info and put selected primary industry_tree IDs here\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).",
"items": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
},
"title": "Huahuo First Industry Ids",
"type": [
"array",
"null"
]
},
"huahuo_second_industry_ids": {
"description": "For the general panel, call /tikhub/bilibili/huahuo/square_static_info and put selected secondary industry_tree IDs here\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).",
"items": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
},
"title": "Huahuo Second Industry Ids",
"type": [
"array",
"null"
]
},
"huahuo_third_industry_ids": {
"description": "For the general panel, call /tikhub/bilibili/huahuo/square_static_info and put selected tertiary industry_tree IDs here\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).",
"items": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
},
"title": "Huahuo Third Industry Ids",
"type": [
"array",
"null"
]
},
"is_boosting": {
"description": "Boosting-status filter: 1=currently boosting, 0=all",
"title": "Is Boosting",
"type": [
"integer",
"null"
]
},
"is_new_enter": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "Whether to select newly onboarded creators.",
"title": "Is New Enter"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Whether to select newly onboarded creators.",
"title": "Is New Enter"
},
"is_painter_order": {
"description": "Whether to require illustration-commission capability",
"title": "Is Painter Order",
"type": [
"boolean",
"null"
]
},
"is_timely_response": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "Whether to require timely-response creators",
"title": "Is Timely Response"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Whether to require timely-response creators",
"title": "Is Timely Response"
},
"is_treasure_up": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "Whether to select treasure creators.",
"title": "Is Treasure Up"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Whether to select treasure creators.",
"title": "Is Treasure Up"
},
"is_x_plan_better_up": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "Whether to filter for X Plan preferred creators",
"title": "Is X Plan Better Up"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Whether to filter for X Plan preferred creators",
"title": "Is X Plan Better Up"
},
"label_array": {
"description": "Call /tikhub/bilibili/huahuo/upper_label_tree first, then put all selected content-type values in one inner array\n\nAPI references: `upper_label_tree` = `GET /tikhub/bilibili/huahuo/upper_label_tree` (operationId: `get_tikhub_bilibili_huahuo_upper_label_tree`).",
"items": {
"items": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
},
"type": "array"
},
"title": "Label Array",
"type": [
"array",
"null"
]
},
"last_14_days_set_price": {
"description": "Quote-updated-in-14-days filter: 1=yes, 0=all",
"title": "Last 14 Days Set Price",
"type": [
"integer",
"null"
]
},
"last_30_days_set_price": {
"description": "Quote-updated-in-30-days filter: 1=yes, 0=all",
"title": "Last 30 Days Set Price",
"type": [
"integer",
"null"
]
},
"last_7_days_set_price": {
"description": "Quote-updated-in-7-days filter: 1=yes, 0=all",
"title": "Last 7 Days Set Price",
"type": [
"integer",
"null"
]
},
"main_search": {
"description": "Content-keyword query; matched videos are included in the result",
"title": "Main Search",
"type": [
"string",
"null"
]
},
"marketing_target": {
"description": "Marketing objective: 1=brand awareness, 2=consideration, 3=conversion",
"title": "Marketing Target",
"type": [
"integer",
"null"
]
},
"max_avid_cnt": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "Maximum eligible original-video count in the last 90 days",
"title": "Max Avid Cnt"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Maximum eligible original-video count in the last 90 days",
"title": "Max Avid Cnt"
},
"max_cpc": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Maximum CPC, calculated as spend divided by component clicks",
"title": "Max Cpc"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Maximum CPC, calculated as spend divided by component clicks",
"title": "Max Cpc"
},
"max_cpm": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Maximum CPM, calculated as spend divided by views times 1,000",
"title": "Max Cpm"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Maximum CPM, calculated as spend divided by views times 1,000",
"title": "Max Cpm"
},
"max_fans_num": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "Maximum follower count, inclusive",
"title": "Max Fans Num"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Maximum follower count, inclusive",
"title": "Max Fans Num"
},
"max_hot_avid_rate": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Maximum viral-video ratio in the last 90 days",
"title": "Max Hot Avid Rate"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Maximum viral-video ratio in the last 90 days",
"title": "Max Hot Avid Rate"
},
"max_interact_rate": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Maximum engagement rate for eligible original videos in the last 180 days",
"title": "Max Interact Rate"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Maximum engagement rate for eligible original videos in the last 180 days",
"title": "Max Interact Rate"
},
"max_play_median": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Maximum median views for eligible original videos published at least seven days ago",
"title": "Max Play Median"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Maximum median views for eligible original videos published at least seven days ago",
"title": "Max Play Median"
},
"max_task_price": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Maximum standard cooperation quote in RMB",
"title": "Max Task Price"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Maximum standard cooperation quote in RMB",
"title": "Max Task Price"
},
"mcn_ids": {
"description": "MCN organization IDs from /tikhub/bilibili/huahuo/mcn_drop\n\nAPI references: `mcn_drop` = `GET /tikhub/bilibili/huahuo/mcn_drop` (operationId: `get_tikhub_bilibili_huahuo_mcn_drop`).",
"items": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
},
"title": "Mcn Ids",
"type": [
"array",
"null"
]
},
"mids": {
"description": "List of creator UIDs to match exactly",
"items": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
},
"title": "Mids",
"type": [
"array",
"null"
]
},
"min_avid_cnt": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "Minimum eligible original-video count in the last 90 days",
"title": "Min Avid Cnt"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Minimum eligible original-video count in the last 90 days",
"title": "Min Avid Cnt"
},
"min_cpc": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Minimum CPC, calculated as spend divided by component clicks",
"title": "Min Cpc"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Minimum CPC, calculated as spend divided by component clicks",
"title": "Min Cpc"
},
"min_cpm": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Minimum CPM, calculated as spend divided by views times 1,000",
"title": "Min Cpm"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Minimum CPM, calculated as spend divided by views times 1,000",
"title": "Min Cpm"
},
"min_fans_num": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "Minimum follower count, inclusive",
"title": "Min Fans Num"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Minimum follower count, inclusive",
"title": "Min Fans Num"
},
"min_hot_avid_rate": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Minimum viral-video ratio in the last 90 days",
"title": "Min Hot Avid Rate"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Minimum viral-video ratio in the last 90 days",
"title": "Min Hot Avid Rate"
},
"min_interact_rate": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Minimum engagement rate for eligible original videos in the last 180 days",
"title": "Min Interact Rate"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Minimum engagement rate for eligible original videos in the last 180 days",
"title": "Min Interact Rate"
},
"min_play_median": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Minimum median views for eligible original videos published at least seven days ago",
"title": "Min Play Median"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Minimum median views for eligible original videos published at least seven days ago",
"title": "Min Play Median"
},
"min_task_price": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Minimum standard cooperation quote in RMB",
"title": "Min Task Price"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Minimum standard cooperation quote in RMB",
"title": "Min Task Price"
},
"nickname_or_mids": {
"description": "Creator nickname or UID query; separate multiple terms with commas",
"title": "Nickname Or Mids",
"type": [
"string",
"null"
]
},
"only_contract": {
"description": "Contract-eligible filter: 1=only eligible creators, 0=all",
"title": "Only Contract",
"type": [
"integer",
"null"
]
},
"order_by": {
"description": "Sort field, such as fans_num, play_median, or interactive_rate",
"title": "Order By",
"type": [
"string",
"null"
]
},
"page": {
"description": "Page number starting at 1; each page contains 20 records.",
"minimum": 1.0,
"title": "Page",
"type": [
"integer",
"null"
]
},
"panel_type": {
"description": "Strategy panel: 0=general, 1=gaming, 2=beauty, 3=digital, 4=automotive, 5=performance, 6=food, 8=internet",
"title": "Panel Type",
"type": [
"integer",
"null"
]
},
"partition_id": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "Primary content-category ID from /tikhub/bilibili/huahuo/partition_drop\n\nAPI references: `partition_drop` = `GET /tikhub/bilibili/huahuo/partition_drop` (operationId: `get_tikhub_bilibili_huahuo_partition_drop`).",
"title": "Partition Id"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Primary content-category ID from /tikhub/bilibili/huahuo/partition_drop\n\nAPI references: `partition_drop` = `GET /tikhub/bilibili/huahuo/partition_drop` (operationId: `get_tikhub_bilibili_huahuo_partition_drop`).",
"title": "Partition Id"
},
"play_median_cycle": {
"description": "Median-view window: 1=7 days, 2=15 days, 3=30 days",
"title": "Play Median Cycle",
"type": [
"integer",
"null"
]
},
"play_median_traffic_type": {
"description": "Median-view traffic scope: 1=all traffic, 2=organic traffic",
"title": "Play Median Traffic Type",
"type": [
"integer",
"null"
]
},
"price_info": {
"description": "Cooperation-pricing filters from price_info_options returned by /tikhub/bilibili/huahuo/square_static_info; send one type per search, include all six fields, and use [] for unavailable arrays\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).",
"items": {
"additionalProperties": true,
"description": "Quote filter for a cooperation format.",
"properties": {
"cooperation_type": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "Cooperation type: 1=embedded video, 2=custom video, 22=deep customization, 23=custom podcast, 24=podcast brand placement, 3=direct post, 4=repost; supported fields are returned in price_info_options.cooperation_type",
"title": "Cooperation Type"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Cooperation type: 1=embedded video, 2=custom video, 22=deep customization, 23=custom podcast, 24=podcast brand placement, 3=direct post, 4=repost; supported fields are returned in price_info_options.cooperation_type",
"title": "Cooperation Type"
},
"creative_skill": {
"description": "Deep-customization skill IDs: 1=Overseas Filming, 2=Hardcore Tech Analysis, 3=Short Film or Mini-movie, 4=Reality Show Challenge, 5=Makeover or DIY, 6=Interview or Street Interview, 7=TVC Production, 8=Specialty Editing, 9=Other; options are returned in price_info_options.creative_skill via /tikhub/bilibili/huahuo/square_static_info\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).",
"items": {
"type": "integer"
},
"title": "Creative Skill",
"type": [
"array",
"null"
]
},
"include_content": {
"description": "Included-content IDs for custom video, deep customization, or custom podcast: 1=Authorized derivative/distribution, 2=Complimentary preview clip, 3=Custom content. Options are returned in price_info_options.include_content",
"items": {
"type": "integer"
},
"title": "Include Content",
"type": [
"array",
"null"
]
},
"price_max": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Maximum quote in RMB; presets are returned in price_info_options.price_range by /tikhub/bilibili/huahuo/square_static_info\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).",
"title": "Price Max"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Maximum quote in RMB; presets are returned in price_info_options.price_range by /tikhub/bilibili/huahuo/square_static_info\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).",
"title": "Price Max"
},
"price_min": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Minimum quote in RMB; presets are returned in price_info_options.price_range by /tikhub/bilibili/huahuo/square_static_info\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).",
"title": "Price Min"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Minimum quote in RMB; presets are returned in price_info_options.price_range by /tikhub/bilibili/huahuo/square_static_info\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).",
"title": "Price Min"
},
"price_right": {
"description": "Cooperation-right codes, e.g. show_in_video_first_1p3, show_in_video_gte_30s, brand_over_30_percent, auth_secondary_creation, multi_cooperation_discount, give_preview, give_poster. Full list and applicable types are in price_info_options.price_right returned by /tikhub/bilibili/huahuo/square_static_info; send [] when unselected or unavailable.\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).",
"items": {
"type": "string"
},
"title": "Price Right",
"type": [
"array",
"null"
]
}
},
"title": "UpperPriceFilter",
"type": "object"
},
"title": "Price Info",
"type": [
"array",
"null"
]
},
"provider_id": {
"description": "Service-provider IDs using values offered by the Huahuo filter",
"items": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
},
"title": "Provider Id",
"type": [
"array",
"null"
]
},
"region_id": {
"description": "Call /tikhub/bilibili/huahuo/region_drop first, then put selected primary-region values in this array\n\nAPI references: `region_drop` = `GET /tikhub/bilibili/huahuo/region_drop` (operationId: `get_tikhub_bilibili_huahuo_region_drop`).",
"items": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
},
"title": "Region Id",
"type": [
"array",
"null"
]
},
"request_id": {
"description": "Search-session ID; reuse it across pages of the same filter set",
"title": "Request Id",
"type": [
"string",
"null"
]
},
"second_partition_id": {
"description": "Secondary content-category IDs from /tikhub/bilibili/huahuo/partition_drop\n\nAPI references: `partition_drop` = `GET /tikhub/bilibili/huahuo/partition_drop` (operationId: `get_tikhub_bilibili_huahuo_partition_drop`).",
"items": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
},
"title": "Second Partition Id",
"type": [
"array",
"null"
]
},
"second_region_id": {
"description": "Call /tikhub/bilibili/huahuo/region_drop first, then put selected child-region values in this array\n\nAPI references: `region_drop` = `GET /tikhub/bilibili/huahuo/region_drop` (operationId: `get_tikhub_bilibili_huahuo_region_drop`).",
"items": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
},
"title": "Second Region Id",
"type": [
"array",
"null"
]
},
"sort": {
"description": "Sort direction: desc=descending, asc=ascending",
"title": "Sort",
"type": [
"string",
"null"
]
},
"spark_tag": {
"description": "Huahuo capability tags, such as cooperate, grow, or hot_frequent. On the general panel, use cooperate for prior cooperation or coo_frequent for frequent cooperation, together with industry-tree values from /tikhub/bilibili/huahuo/square_static_info.\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).",
"items": {
"type": "string"
},
"title": "Spark Tag",
"type": [
"array",
"null"
]
},
"special_tags": {
"description": "Feature-tag values from /tikhub/bilibili/huahuo/square_static_info\n\nAPI references: `square_static_info` = `GET /tikhub/bilibili/huahuo/square_static_info` (operationId: `get_tikhub_bilibili_huahuo_square_static_info`).",
"items": {
"type": "string"
},
"title": "Special Tags",
"type": [
"array",
"null"
]
},
"square_tag_in": {
"description": "Marketplace scenario tags, such as ad_partner_experienced.",
"items": {
"type": "string"
},
"title": "Square Tag In",
"type": [
"array",
"null"
]
},
"upper_mid": {
"anyOf": [
{
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"description": "Single creator UID for an exact match",
"title": "Upper Mid"
},
{
"enum": [
null
],
"type": [
"string",
"null"
]
}
],
"description": "Single creator UID for an exact match",
"title": "Upper Mid"
},
"upper_types": {
"description": "Creator type: 1 or 4=MCN-affiliated, 3=independent",
"items": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
},
"title": "Upper Types",
"type": [
"array",
"null"
]
}
},
"title": "UpperSearchBody",
"type": "object"
}
}
}
},
"x-aisa-status": "enabled",
"x-aisa-pricing": {
"cost_contract": "fixed_success",
"customer_multiplier": 1.0,
"customer_pricing": "provider_cost_multiplier",
"default_request_estimate_usd": 0.01,
"estimate_source": "profile_seed",
"evidence_source": "request_snapshot"
},
"components": {
"securitySchemes": {
"bearerAuth": {
"scheme": "bearer",
"type": "http"
}
}
}
}
费用与请求规则
公开参考价格：每次成功请求 $0.01 USD。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口，执行前请针对完整请求获取免费报价；执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。- 默认请求参考估价（USD）: 0.01
- 计费依据: fixed_success
- 公开参考倍率: 1.0
- 结算证据来源: request_snapshot
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
application/json
Search modes:
nickname_or_mids: Search by creator nickname or UID; separate multiple terms with commas.main_search: Search by content keyword and include matched videos in the response.mids/upper_mid: Match one or more creator UIDs exactly.
Filter groups:
- Profile and affiliation: gender, followers, region, content category, MCN, service provider, and account type.
- Audience profile: age, gender, region affinity, and follower loyalty.
- Pricing and performance: quote, engagement rate, median views, CPM, CPC, CPE, and store-entry cost.
- Content and cooperation: post count, viral-post ratio, video duration, honors, industries, and cooperation experience.
- Commerce: permission, level, categories, GPM, component CTR, and average product price.
- Audience packages and labels: DMP packages, feature tags, content-type trees, and high-potential tags.
Every field is optional. Send ratio fields as decimal values (for example,
0.05 for 5%) and monetary fields as the RMB values displayed by Huahuo.
Dynamic IDs are available from square_static_info, upper_label_tree,
and the corresponding dropdown endpoints.
[Example]
{
"nickname_or_mids": "2233,xiaodianshi",
"marketing_target": 1,
"panel_type": 0,
"min_fans_num": 100000,
"max_fans_num": 1000000,
"min_interact_rate": 0.03,
"play_median_traffic_type": 1,
"play_median_cycle": 3,
"price_info": [{
"cooperation_type": 1,
"creative_skill": [],
"include_content": [],
"price_min": 1000,
"price_max": 10000,
"price_right": []
}],
"goods_ctr_type": 1,
"page": 1
}
API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info); upper_label_tree = GET /tikhub/bilibili/huahuo/upper_label_tree (operationId: get_tikhub_bilibili_huahuo_upper_label_tree).
Recent-publishing activity switch: 1=enabled, 0=all
Recent-publishing activity tier from av_active_tag returned by /tikhub/bilibili/huahuo/square_static_info
API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info).
Video honors have no separate options endpoint; use the search_upper documentation and always send honor_type as an array
API references: search_upper = POST /tikhub/bilibili/huahuo/search_upper (operationId: post_tikhub_bilibili_huahuo_search_upper).
Show child attributes
Show child attributes
Bilibili level-five content-tag filter values
Minimum blue-link click cost, cooperation and promotion spend divided by clicks
Maximum blue-link click cost, cooperation and promotion spend divided by clicks
Minimum blue-link CTR, blue-link clicks divided by video views
Maximum blue-link CTR, blue-link clicks divided by video views
Content-category DMP audience-package ID
Display label for the content-category DMP audience package
For non-general panels, call /tikhub/bilibili/huahuo/cooperate_experience_industry first and put selected IDs here; unused by the general panel
API references: cooperate_experience_industry = GET /tikhub/bilibili/huahuo/cooperate_experience_industry (operationId: get_tikhub_bilibili_huahuo_cooperate_experience_industry).
Experience type for non-general strategy panels: 1=experienced, 2=extensive, 3=none in current industry, 4=experience in other industries; use 1 or 2 with selected industries, while the general panel uses spark_tag
CPC window: 1=7 days, 2=15 days, 3=30 days
CPC traffic scope: 1=all traffic, 2=organic traffic
CPE window: 1=7 days, 3=30 days
Minimum CPE, calculated as spend divided by valid engagements
Maximum CPE, calculated as spend divided by valid engagements
CPE traffic scope: 1=all traffic, 2=organic traffic
CPM window: 1=7 days, 2=15 days, 3=30 days
CPM traffic scope: 1=all traffic, 2=organic traffic
Whether custom-video pricing has been configured
Usage: Require configured custom-video pricing;
is_x_plan_better_up: X Plan preferred creators.
DMP custom audience-package ID from /tikhub/bilibili/huahuo/dmp_pkg_list
API references: dmp_pkg_list = GET /tikhub/bilibili/huahuo/dmp_pkg_list (operationId: get_tikhub_bilibili_huahuo_dmp_pkg_list).
Minimum DMP influence: recent matching viewers divided by the audience population
Maximum DMP influence: recent matching viewers divided by the audience population
Minimum DMP attention: matching audience members divided by all followers
Maximum DMP attention: matching audience members divided by all followers
DMP special-audience package name query
Minimum DMP verticality: matching videos divided by all videos
Maximum DMP verticality: matching videos divided by all videos
Dominant video duration: 1=0-30s, 2=30-60s, 3=1-3min, 4=3-5min, 5=5-10min, 6=over 10min
Maximum store-entry cost for relevant cooperation in the last year
Minimum store-entry cost for relevant cooperation in the last year
Audience age-affinity tags from /tikhub/bilibili/huahuo/square_static_info
API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info).
Audience gender-affinity tags from /tikhub/bilibili/huahuo/square_static_info
API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info).
Audience region-affinity tags from /tikhub/bilibili/huahuo/square_static_info
API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info).
Follower-loyalty filter: 0 means unrestricted; obtain other values from the static filter options.
Saved-creator folder ID used to limit the search
Creator gender from gender_info returned by /tikhub/bilibili/huahuo/square_static_info
API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info).
Maximum average product price in the last 30 days, in RMB
Minimum average product price in the last 30 days, in RMB
Primary commerce-category IDs from /tikhub/bilibili/huahuo/effect_goods_drop
API references: effect_goods_drop = GET /tikhub/bilibili/huahuo/effect_goods_drop (operationId: get_tikhub_bilibili_huahuo_effect_goods_drop).
Secondary commerce-category IDs from /tikhub/bilibili/huahuo/effect_goods_drop
API references: effect_goods_drop = GET /tikhub/bilibili/huahuo/effect_goods_drop (operationId: get_tikhub_bilibili_huahuo_effect_goods_drop).
Maximum commerce-component CTR, clicks divided by impressions
Minimum commerce-component CTR, clicks divided by impressions
Commerce CTR component scope: 1=all components, 2=comment component
Maximum 30-day GPM, paid GMV per 1,000 commerce-video views
Minimum 30-day GPM, paid GMV per 1,000 commerce-video views
High follower-view penetration filter
High video-view penetration filter, top 20% by recent viewers per follower
Commerce permission filter: 1=required, 0=all
Commerce-creator level values
Maximum viral-video count in the last six months
Minimum viral-video count in the last six months
High-potential type: 0=all, 1=onboarded, 2=not onboarded
For the general panel, call /tikhub/bilibili/huahuo/square_static_info and put selected primary industry_tree IDs here
API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info).
For the general panel, call /tikhub/bilibili/huahuo/square_static_info and put selected secondary industry_tree IDs here
API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info).
For the general panel, call /tikhub/bilibili/huahuo/square_static_info and put selected tertiary industry_tree IDs here
API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info).
Boosting-status filter: 1=currently boosting, 0=all
Whether to select newly onboarded creators.
Whether to require illustration-commission capability
Whether to require timely-response creators
Whether to select treasure creators.
Whether to filter for X Plan preferred creators
Call /tikhub/bilibili/huahuo/upper_label_tree first, then put all selected content-type values in one inner array
API references: upper_label_tree = GET /tikhub/bilibili/huahuo/upper_label_tree (operationId: get_tikhub_bilibili_huahuo_upper_label_tree).
Quote-updated-in-14-days filter: 1=yes, 0=all
Quote-updated-in-30-days filter: 1=yes, 0=all
Quote-updated-in-7-days filter: 1=yes, 0=all
Content-keyword query; matched videos are included in the result
Marketing objective: 1=brand awareness, 2=consideration, 3=conversion
Maximum eligible original-video count in the last 90 days
Maximum CPC, calculated as spend divided by component clicks
Maximum CPM, calculated as spend divided by views times 1,000
Maximum follower count, inclusive
Maximum viral-video ratio in the last 90 days
Maximum engagement rate for eligible original videos in the last 180 days
Maximum median views for eligible original videos published at least seven days ago
Maximum standard cooperation quote in RMB
MCN organization IDs from /tikhub/bilibili/huahuo/mcn_drop
API references: mcn_drop = GET /tikhub/bilibili/huahuo/mcn_drop (operationId: get_tikhub_bilibili_huahuo_mcn_drop).
List of creator UIDs to match exactly
Minimum eligible original-video count in the last 90 days
Minimum CPC, calculated as spend divided by component clicks
Minimum CPM, calculated as spend divided by views times 1,000
Minimum follower count, inclusive
Minimum viral-video ratio in the last 90 days
Minimum engagement rate for eligible original videos in the last 180 days
Minimum median views for eligible original videos published at least seven days ago
Minimum standard cooperation quote in RMB
Creator nickname or UID query; separate multiple terms with commas
Contract-eligible filter: 1=only eligible creators, 0=all
Sort field, such as fans_num, play_median, or interactive_rate
Page number starting at 1; each page contains 20 records.
必填范围:
x >= 1Strategy panel: 0=general, 1=gaming, 2=beauty, 3=digital, 4=automotive, 5=performance, 6=food, 8=internet
Primary content-category ID from /tikhub/bilibili/huahuo/partition_drop
API references: partition_drop = GET /tikhub/bilibili/huahuo/partition_drop (operationId: get_tikhub_bilibili_huahuo_partition_drop).
Median-view window: 1=7 days, 2=15 days, 3=30 days
Median-view traffic scope: 1=all traffic, 2=organic traffic
Cooperation-pricing filters from price_info_options returned by /tikhub/bilibili/huahuo/square_static_info; send one type per search, include all six fields, and use [] for unavailable arrays
API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info).
Show child attributes
Show child attributes
Service-provider IDs using values offered by the Huahuo filter
Call /tikhub/bilibili/huahuo/region_drop first, then put selected primary-region values in this array
API references: region_drop = GET /tikhub/bilibili/huahuo/region_drop (operationId: get_tikhub_bilibili_huahuo_region_drop).
Search-session ID; reuse it across pages of the same filter set
Secondary content-category IDs from /tikhub/bilibili/huahuo/partition_drop
API references: partition_drop = GET /tikhub/bilibili/huahuo/partition_drop (operationId: get_tikhub_bilibili_huahuo_partition_drop).
Call /tikhub/bilibili/huahuo/region_drop first, then put selected child-region values in this array
API references: region_drop = GET /tikhub/bilibili/huahuo/region_drop (operationId: get_tikhub_bilibili_huahuo_region_drop).
Sort direction: desc=descending, asc=ascending
Huahuo capability tags, such as cooperate, grow, or hot_frequent. On the general panel, use cooperate for prior cooperation or coo_frequent for frequent cooperation, together with industry-tree values from /tikhub/bilibili/huahuo/square_static_info.
API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info).
Feature-tag values from /tikhub/bilibili/huahuo/square_static_info
API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info).
Marketplace scenario tags, such as ad_partner_experienced.
Single creator UID for an exact match
Creator type: 1 or 4=MCN-affiliated, 3=independent
响应
Successful Response
Returns
page: Current page number.total_count: Total matching records, displayed up to 10,000.data: Creator records commonly containingupper_mid,nickname,fans_num,play_median,interactive_rate, pricing, content and industry labels, DMP measurements, and commerce metrics. Content-search results also include matched videos.
cache_message
string | null
默认值:This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.
Cache message (EN-US)
cache_message_zh
string | null
默认值:本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。
Cache message (ZH-CN)
The URL to access the cached result
HTTP 状态码
Endpoint-specific response payload. The official shared model does not declare a fixed type or field set. Use the operation's documented return fields or response example; an operation-specific schema, when present, describes the documented fields. Undocumented fields must be read from the actual response rather than assumed.
Link to the API Swagger documentation for this endpoint
Response message (EN-US)
Response message (ZH-CN)
The parameters used in the request
Unique request identifier
The endpoint that generated this response
Support message
The time the response was generated
The timestamp the response was generated
The timezone of the response time