Тема
Язык
POST$0.013 за запрос · $13.00 за 1 000 запросов

Поиск ведущего

Поиск авторов или контента 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 · целое число

Идентификатор папки сохранённых авторов, используемый для ограничения поиска

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 · строка

Идентификатор сеанса поиска; повторно используйте его для страниц с тем же набором фильтров

gender

body · строка

Пол автора из gender_info, возвращаемого /api/v1/bilibili/huahuo/square_static_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

second_partition_id

body · массив

api/v1/bilibili/huahuo/partition_drop / Идентификаторы дополнительных категорий контента из /api/v1/bilibili/huahuo/partition_drop

mcn_ids

body · массив

api/v1/bilibili/huahuo/mcn_drop / Идентификаторы организаций MCN из /api/v1/bilibili/huahuo/mcn_drop

provider_id

body · массив

Идентификаторы поставщиков услуг с использованием значений, предлагаемых фильтром Huahuo

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=все, в противном случае используйте значение из статических параметров

av_active

body · целое число

Переключатель активности недавних публикаций: 1 = включено, 0 = все

av_active_tag

body · строка

Уровень активности недавних публикаций из av_active_tag, возвращаемого методом /api/v1/bilibili/huahuo/square_static_info

dmp_group_id

body · целое число

api/v1/bilibili/huahuo/dmp_pkg_list / Идентификатор пользовательского пакета аудитории DMP из /api/v1/bilibili/huahuo/dmp_pkg_list

category_dmp_group_id

body · целое число

ID пакета аудитории DMP категории контента

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 · массив

Фильтры стоимости сотрудничества из price_info_options, возвращаемого /api/v1/bilibili/huahuo/square_static_info; отправляйте один тип за один поиск, включайте все шесть полей и используйте [] для недоступных массивов

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 · целое число

Минимальное медианное количество просмотров подходящих оригинальных видео, опубликованных не менее семи дней назад

max_play_median

body · целое число

Максимальное медианное количество просмотров подходящих оригинальных видео, опубликованных не менее семи дней назад

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 · целое число

Минимальное количество вирусных видео за последние шесть месяцев

half_max_hot_avid_cnt

body · целое число

Максимальное количество вирусных видео за последние шесть месяцев

entry_cost_min

body · целое число

Минимальная стоимость перехода в магазин для соответствующего сотрудничества за последний год

entry_cost_max

body · целое число

Максимальная стоимость перехода в магазин для соответствующего сотрудничества за последний год

av_honor

body · объект

Для наград видео нет отдельной конечной точки параметров; используйте документацию 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; для подсчёта количества сотрудничеств на общей панели используются cooperate или coo_frequent вместе со значениями дерева отраслей из /api/v1/bilibili/huahuo/square_static_info

square_tag_in

body · массив

Теги сценария торговой площадки, например ad_partner_experienced

label_array

body · массив

Сначала вызовите /api/v1/bilibili/huahuo/upper_label_tree, затем укажите все выбранные значения типов контента в одном внутреннем массиве

bdata_tag_lv5

body · массив

Значения фильтра тегов контента пятого уровня Bilibili

huahuo_first_industry_ids

body · массив

Для общей панели вызовите /api/v1/bilibili/huahuo/square_static_info и укажите здесь выбранные ID отраслей первого уровня из industry_tree

huahuo_second_industry_ids

body · массив

Для общей панели вызовите /api/v1/bilibili/huahuo/square_static_info и укажите здесь выбранные ID отраслей второго уровня из industry_tree

huahuo_third_industry_ids

body · массив

Для общей панели вызовите /api/v1/bilibili/huahuo/square_static_info и укажите здесь выбранные ID отраслей третьего уровня из industry_tree

goods_permission

body · целое число

Фильтр разрешения Commerce: 1=обязательные, 0=все

goods_up_levels

body · массив

Значения уровня Commerce-creator

goods_category_first_ids

body · массив

api/v1/bilibili/huahuo/effect_goods_drop / Идентификаторы основных категорий товаров из /api/v1/bilibili/huahuo/effect_goods_drop

goods_category_second_ids

body · массив

api/v1/bilibili/huahuo/effect_goods_drop / Идентификаторы дополнительных категорий товаров из /api/v1/bilibili/huahuo/effect_goods_drop

goods_gpm_min

body · целое число

Минимальный GPM за 30 дней, оплаченный GMV на 1 000 просмотров коммерческих видео

goods_gpm_max

body · целое число

Максимальный GPM за 30 дней, оплаченный GMV на 1 000 просмотров коммерческих видео

goods_ctr_min

body · целое число

Минимальный CTR коммерческого компонента, количество кликов, делённое на количество показов

goods_ctr_max

body · целое число

Максимальный CTR коммерческого компонента, количество кликов, делённое на количество показов

goods_ctr_type

body · целое число

Охват компонента Commerce 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 · целое число

Фильтровать ли авторов-сокровищ

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

Получить API-ключВсе методы Bilibili
Поиск ведущего — Bilibili API | GetVibe API