テーマ
言語
POSTリクエスト1件あたり$0.013 · 1,000リクエストあたり$13.00

配信者を検索

Huahuo クリエイターまたはコンテンツを検索

エンドポイント

POST https://getvibeapi.com/v1/social/bilibili/huahuo/search_upper

例

curl -sS "https://getvibeapi.com/v1/social/bilibili/huahuo/search_upper" \
  -H "Authorization: Bearer $GETVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary '{}'

Authorization: Bearerヘッダーにキーを指定してください。料金が発生するのは、データプロバイダーが受け付けたリクエストのみです。プロバイダーが拒否したリクエスト(エラー、タイムアウト、無効なパラメーター)には料金が発生しません。プラットフォームから空の結果または見つからない結果が返された有効なリクエストには料金が発生します。

パラメータ

nickname_or_mids

body · 文字列

クリエイターのニックネームまたはUIDのクエリ。複数の語句はカンマで区切ります

main_search

body · 文字列

コンテンツキーワードクエリ。一致する動画が結果に含まれます

mids

body · 配列

完全一致させるクリエイター UID のリスト

upper_mid

body · 整数

完全一致用の単一クリエイターUID

folder_id

body · 整数

検索範囲を限定するために使用する保存済みクリエイターフォルダー ID

marketing_target

body · 整数

Marketing objective: 1=brand awareness, 2=consideration, 3=conversion

panel_type

body · 整数

Strategy panel: 0=general, 1=gaming, 2=beauty, 3=digital, 4=automotive, 5=performance, 6=food, 8=internet

order_by

body · 文字列

並べ替えフィールド。例:fans_num、play_median、interactive_rate

sort

body · 文字列

Sort direction: desc=descending, asc=ascending

page

body · 整数

1から始まるページ番号。各ページは20件のレコードを返します

request_id

body · 文字列

検索セッションID。同じフィルターセットのページ間で再利用します

gender

body · 文字列

/api/v1/bilibili/huahuo/square_static_info が返す gender_info のクリエイターの性別

min_fans_num

body · 整数

フォロワー数の最小値(この値を含む)

max_fans_num

body · 整数

フォロワー数の最大値(この値を含む)

region_id

body · 配列

まず /api/v1/bilibili/huahuo/region_drop を呼び出し、選択した主要地域の値をこの配列に設定します

second_region_id

body · 配列

まず /api/v1/bilibili/huahuo/region_drop を呼び出し、選択した子地域の値をこの配列に設定します

partition_id

body · 整数

api/v1/bilibili/huahuo/partition_drop / /api/v1/bilibili/huahuo/partition_drop の第1階層コンテンツカテゴリID

second_partition_id

body · 配列

api/v1/bilibili/huahuo/partition_drop / /api/v1/bilibili/huahuo/partition_drop の第2階層コンテンツカテゴリID

mcn_ids

body · 配列

api/v1/bilibili/huahuo/mcn_drop / /api/v1/bilibili/huahuo/mcn_drop のMCN組織ID

provider_id

body · 配列

Huahuoフィルターで提供される値を使用するサービスプロバイダーID

upper_types

body · 配列

Creator type: 1 or 4=MCN-affiliated, 3=independent

only_contract

body · 整数

契約対象フィルター: 1=対象クリエイターのみ、0=すべて

is_painter_order

body · ブール値

イラスト受託機能を必須にするかどうか

fans_age_tag

body · 配列

api/v1/bilibili/huahuo/square_static_info / /api/v1/bilibili/huahuo/square_static_info のオーディエンス年齢関心タグ

fans_gender_tag

body · 配列

api/v1/bilibili/huahuo/square_static_info / /api/v1/bilibili/huahuo/square_static_info のオーディエンス性別関心タグ

fans_region_tag

body · 配列

api/v1/bilibili/huahuo/square_static_info / /api/v1/bilibili/huahuo/square_static_info のオーディエンス地域関心タグ

fans_stick

body · 整数

フォロワーのロイヤルティフィルター。0=すべて。それ以外の場合は static-option の値を使用します

av_active

body · 整数

最近の公開アクティビティスイッチ:1=enabled、0=all

av_active_tag

body · 文字列

/api/v1/bilibili/huahuo/square_static_info から返される av_active_tag の最近の公開アクティビティ層

dmp_group_id

body · 整数

api/v1/bilibili/huahuo/dmp_pkg_list / /api/v1/bilibili/huahuo/dmp_pkg_list のDMPカスタムオーディエンスパッケージID

category_dmp_group_id

body · 整数

コンテンツカテゴリDMPオーディエンスパッケージID

category_dmp_label

body · 文字列

コンテンツカテゴリのDMPオーディエンスパッケージに表示するラベル

dmp_pkg_name

body · 文字列

DMP特殊オーディエンスパッケージ名のクエリ

dmp_pkg_vertical_rate_gte

body · 整数

DMPバーティカリティの最小値:一致する動画数を全動画数で割った値

dmp_pkg_vertical_rate_lte

body · 整数

DMPバーティカリティの最大値:一致する動画数を全動画数で割った値

dmp_pkg_effect_rate_gte

body · 整数

DMPインフルエンスの最小値:最近の一致する視聴者数をオーディエンス数で割った値

dmp_pkg_effect_rate_lte

body · 整数

DMPインフルエンスの最大値:最近の一致する視聴者数をオーディエンス数で割った値

dmp_pkg_fan_rate_gte

body · 整数

DMPアテンションの最小値:一致するオーディエンスメンバー数を全フォロワー数で割った値

dmp_pkg_fan_rate_lte

body · 整数

DMPアテンションの最大値:一致するオーディエンスメンバー数を全フォロワー数で割った値

min_task_price

body · 整数

標準協業見積価格の最小値(RMB)

max_task_price

body · 整数

標準協業見積価格の最大値(RMB)

price_info

body · 配列

/api/v1/bilibili/huahuo/square_static_info が返す price_info_options の協業料金フィルター。検索ごとに1つのタイプを送信し、6つのフィールドをすべて含め、利用できない配列には [] を使用します

last_7_days_set_price

body · 整数

Quote-updated-in-7-days filter: 1=yes, 0=all

last_14_days_set_price

body · 整数

Quote-updated-in-14-days filter: 1=yes, 0=all

last_30_days_set_price

body · 整数

Quote-updated-in-30-days filter: 1=yes, 0=all

min_interact_rate

body · 整数

過去180日間の対象オリジナル動画のエンゲージメント率の最小値

max_interact_rate

body · 整数

過去180日間の対象オリジナル動画のエンゲージメント率の最大値

blue_url_ctr_gte

body · 整数

青色リンクCTRの最小値、青色リンクのクリック数を動画再生数で割った値

blue_url_ctr_lt

body · 整数

青色リンクCTRの最大値、青色リンクのクリック数を動画再生数で割った値

blue_url_click_cost_gte

body · 整数

青色リンクのクリック単価の最小値、協業およびプロモーションの消化金額をクリック数で割った値

blue_url_click_cost_lt

body · 整数

青色リンクのクリック単価の最大値、協業およびプロモーションの消化金額をクリック数で割った値

min_play_median

body · 整数

7日以上前に公開された対象オリジナル動画の再生数中央値の最小値

max_play_median

body · 整数

7日以上前に公開された対象オリジナル動画の再生数中央値の最大値

play_median_traffic_type

body · 整数

再生数中央値のトラフィック範囲:1=すべてのトラフィック、2=オーガニックトラフィック

play_median_cycle

body · 整数

再生数中央値の期間:1=7日間、2=15日間、3=30日間

min_cpm

body · 整数

CPMの最小値、消化金額を再生数で割って1,000を乗じて算出

max_cpm

body · 整数

CPMの最大値、消化金額を再生数で割って1,000を乗じて算出

cpm_type

body · 整数

CPMトラフィック範囲: 1=すべてのトラフィック、2=オーガニックトラフィック

cpm_cycle

body · 整数

CPM期間: 1=7日間、2=15日間、3=30日間

min_cpc

body · 整数

CPCの最小値、消化金額をコンポーネントのクリック数で割って算出

max_cpc

body · 整数

CPCの最大値、消化金額をコンポーネントのクリック数で割って算出

cpc_traffic_type

body · 整数

CPCトラフィック範囲:1=すべてのトラフィック、2=オーガニックトラフィック

cpc_cycle

body · 整数

CPC期間:1=7日間、2=15日間、3=30日間

cpe_gte

body · 整数

CPEの最小値、消化金額を有効なエンゲージメント数で割って算出

cpe_lt

body · 整数

CPEの最大値、消化金額を有効なエンゲージメント数で割って算出

cpe_traffic_type

body · 整数

CPEトラフィック範囲: 1=すべてのトラフィック、2=オーガニックトラフィック

cpe_cycle

body · 整数

CPE期間: 1=7日間、3=30日間

draft_duration

body · 整数

30秒未満から10分超までの、動画時間で最も多い区分

min_avid_cnt

body · 整数

過去90日間の対象オリジナル動画数の最小値

max_avid_cnt

body · 整数

過去90日間の対象オリジナル動画数の最大値

min_hot_avid_rate

body · 整数

過去90日間のバイラル動画比率の最小値

max_hot_avid_rate

body · 整数

過去90日間のバイラル動画比率の最大値

half_min_hot_avid_cnt

body · 整数

過去6か月間のバイラル動画数の最小値

half_max_hot_avid_cnt

body · 整数

過去6か月間のバイラル動画数の最大値

entry_cost_min

body · 整数

過去1年間の関連協業におけるストア流入コストの最小値

entry_cost_max

body · 整数

過去1年間の関連協業におけるストア流入コストの最大値

av_honor

body · オブジェクト

動画の honors には個別のオプションエンドポイントがありません。search_upper のドキュメントを使用し、常に honor_type を配列として送信してください

cooperate_experience_industry_ids

body · 配列

一般パネル以外では、先に /api/v1/bilibili/huahuo/cooperate_experience_industry を呼び出し、選択した ID をここに設定します。一般パネルでは使用しません

cooperate_experience_type

body · 整数

一般向けではない戦略パネルの体験タイプ:1=経験あり、2=幅広い経験、3=現在の業界で該当なし、4=他業界で経験あり。選択した業界では1または2を使用し、一般パネルではspark_tagを使用します

special_tags

body · 配列

api/v1/bilibili/huahuo/square_static_info / Feature-tag values from /api/v1/bilibili/huahuo/square_static_info

spark_tag

body · 配列

Huahuoの機能タグ。general-panelの協力数では、/api/v1/bilibili/huahuo/square_static_infoの業種ツリー値とともにcooperateまたはcoo_frequentを使用します

square_tag_in

body · 配列

ad_partner_experienced などのマーケットプレイスシナリオタグ

label_array

body · 配列

まず /api/v1/bilibili/huahuo/upper_label_tree を呼び出し、選択したすべてのコンテンツタイプの値を1つの内部配列に設定します

bdata_tag_lv5

body · 配列

Bilibiliの5段階コンテンツタグフィルター値

huahuo_first_industry_ids

body · 配列

一般パネルでは、/api/v1/bilibili/huahuo/square_static_info を呼び出し、選択した第 1 階層の industry_tree ID をここに設定します

huahuo_second_industry_ids

body · 配列

一般パネルでは、/api/v1/bilibili/huahuo/square_static_info を呼び出し、選択した第 2 階層の industry_tree ID をここに設定します

huahuo_third_industry_ids

body · 配列

一般パネルでは、/api/v1/bilibili/huahuo/square_static_info を呼び出し、選択した第 3 階層の industry_tree ID をここに設定します

goods_permission

body · 整数

コマース権限フィルター: 1=必須、0=すべて

goods_up_levels

body · 配列

コマースクリエイターレベルの値

goods_category_first_ids

body · 配列

api/v1/bilibili/huahuo/effect_goods_drop / /api/v1/bilibili/huahuo/effect_goods_drop の第1階層コマースカテゴリID

goods_category_second_ids

body · 配列

api/v1/bilibili/huahuo/effect_goods_drop / /api/v1/bilibili/huahuo/effect_goods_drop の第2階層コマースカテゴリID

goods_gpm_min

body · 整数

30日間GPMの最小値、コマース動画1,000回再生あたりの有料GMV

goods_gpm_max

body · 整数

30日間GPMの最大値、コマース動画1,000回再生あたりの有料GMV

goods_ctr_min

body · 整数

コマースコンポーネントCTRの最小値、クリック数をインプレッション数で割った値

goods_ctr_max

body · 整数

コマースコンポーネントCTRの最大値、クリック数をインプレッション数で割った値

goods_ctr_type

body · 整数

コマースCTRコンポーネント範囲: 1=すべてのコンポーネント、2=コメントコンポーネント

goods_avg_price_min

body · 整数

過去30日間の平均商品価格の最小値(RMB)

goods_avg_price_max

body · 整数

過去30日間の平均商品価格の最大値(RMB)

goods_is_high_video_play_permeate

body · 整数

動画視聴数の浸透率が高いもののフィルター。最近の視聴者数をフォロワー数で割った上位20%

goods_is_high_fans_play_permeate

body · 整数

フォロワー数に対する視聴数の浸透率が高いもののフィルター

is_boosting

body · 整数

ブーストステータスフィルター:1=現在ブースト中、0=すべて

is_treasure_up

body · 整数

treasure クリエイターでフィルターするかどうか

is_timely_response

body · 整数

迅速な応答が可能なクリエイターを必須にするかどうか

is_new_enter

body · 整数

新しく登録されたクリエイターでフィルターするかどうか

custom_video_pricing_set

body · 整数

カスタム動画の料金が設定されているかどうか

is_x_plan_better_up

body · 整数

X Plan の優先クリエイターでフィルターするかどうか

high_potential_type

body · 整数

High-potential type: 0=all, 1=onboarded, 2=not onboarded

配信者を検索 — Bilibili API | GetVibe API