{ "openapi": "3.0.0", "info": { "title": "Douyin Creator Marketplace (Xingtu) Creator Search API (V1)", "version": "1.0.0", "description": "Get Douyin Creator Marketplace (Xingtu) creator Search data, including filters, returning profile, and audience, for discovery, comparison, and shortlist building." }, "paths": { "/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1": { "get": { "tags": [ "Douyin Creator Marketplace (Xingtu)" ], "summary": "Creator Search", "description": "Get Douyin Creator Marketplace (Xingtu) creator Search data, including filters, returning profile, and audience, for discovery, comparison, and shortlist building.", "operationId": "gwApiGsearchSearchForAuthorSquareV1", "parameters": [ { "name": "token", "in": "query", "description": "User authentication token.", "required": true, "schema": { "type": "string" } }, { "name": "keyword", "in": "query", "description": "Search keyword.", "required": false, "schema": { "type": "string", "default": "" } }, { "name": "page", "in": "query", "description": "Page number for pagination.", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "searchType", "in": "query", "description": "Search criteria type.\n\nAvailable Values:\n- `NICKNAME`: By Nickname\n- `CONTENT`: By Content", "required": false, "schema": { "type": "string", "default": "NICKNAME", "description": "Search criteria type", "enum": [ "NICKNAME", "CONTENT" ] } }, { "name": "followerRange", "in": "query", "description": "Follower range (e.g., 10-100).", "required": false, "schema": { "type": "string" } }, { "name": "kolPriceType", "in": "query", "description": "KOL price type.\n\nAvailable Values:\n- `视频1_20s`: Video 1-20s\n- `视频21_60s`: Video 21-60s\n- `视频60s以上`: Video > 60s\n- `定制短剧单集`: Mini-drama episode\n- `千次自然播放量`: CPM naturally\n- `短直种草视频`: Short-live seeding video\n- `短直预热视频`: Short-live warm-up video\n- `短直明星种草`: Celebrity short-live seeding\n- `短直明星预热`: Celebrity short-live warm-up\n- `明星视频`: Celebrity video\n- `合集视频`: Collection video\n- `抖音短视频共创_主投稿达人`: Douyin short video co-creation - main creator\n- `抖音短视频共创_参与达人`: Douyin short video co-creation - participant", "required": false, "schema": { "type": "string", "description": "KOL price category", "enum": [ "视频1_20s", "视频21_60s", "视频60s以上", "定制短剧单集", "千次自然播放量", "短直种草视频", "短直预热视频", "短直明星种草", "短直明星预热", "明星视频", "合集视频", "抖音短视频共创_主投稿达人", "抖音短视频共创_参与达人" ] } }, { "name": "kolPriceRange", "in": "query", "description": "KOL price range (e.g., 10000-50000).", "required": false, "schema": { "type": "string" } }, { "name": "contentTag", "in": "query", "description": "Content tag filter.", "required": false, "schema": { "type": "string" } } ], "responses": { "default": { "description": "default response", "content": { "application/json": { "example": { "code": 0, "data": { "authors": [ { "attribute_datas": { "author_avatar_frame_icon": "0", "author_ecom_level": "L4", "author_level_game": "Lv1", "author_level_other": "Lv1", "author_status": "1", "author_thin_mid_word_association_index": "{\"清爽\":0.003}", "author_type": "3", "avatar_uri": "https://p3.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_a4391e9fc88a3ed36b0448661f82bc...", "brand_boost_vv": "0", "city": "", "content_theme_labels_180d": "[\"异国旅行\",\"海外旅行\",\"美食探店\",\"家庭生活记录\",\"环球影城之旅\",\"游乐园游玩\",\"三角洲新赛季\",\"个人模仿秀\",\"游戏赛事指南\",\"游戏体验展示\"]", "core_user_id": "84990209480", "e_commerce_enable": "1", "ecom_avg_order_value_30d_range": "50-200", "ecom_gmv_30d_range": ">100w", "ecom_gpm_30d_range": "1000-3000", "ecom_score": "89", "ecom_video_product_num_30d": "0", "ecom_watch_pv_30d": "1.3", "expected_cpa3_level": "4", "expected_natural_play_num": "4532776", "expected_play_num": "3535761", "fans_increment_rate_within_15d": "-0.00033109494533874244", "fans_increment_within_15d": "-21105", "fans_increment_within_30d": "8352287.33", "follower": "63747138", "game_type": "{\"\\u5c04\\u51fb\": 1.0}", "gender": "1", "grade": "0", "id": "6855230644880949262", "interact_rate_within_30d": "0.033", "is_black_horse_author": "false", "is_cocreate_author": "false", "is_cpm_project_author": "0", "is_excellenct_author": "0", "is_short_drama": "0", "last_10_items": "[{\"comment_cnt\":\"1138\",\"is_high_quality_item\":\"0\",\"item_create_time\":\"1772962802\",\"item_id\":\"7614816...", "link_convert_index": "99.48", "link_convert_index_by_industry": "99.48", "link_i_cnt_by_industry": "29863242", "link_k_cnt_by_industry": "74458", "link_l_cnt_by_industry": "42264967", "link_link_cnt_by_industry": "96324334", "link_n_cnt_by_industry": "24121667", "link_recommend_index_by_industry": "94.3", "link_shopping_index": "94.3", "link_spread_index": "94.28", "link_spread_index_by_industry": "94.28", "link_star_index": "86.28", "link_star_index_by_industry": "86.28", "link_user_type_by_industry": "2", "local_lower_threshold_author": "false", "nick_name": "陈赫", "pic_brand_boost": "false", "pic_brand_boost_vv": "0", "pic_expected_play_num": "566107", "play_over_rate_within_30d": "0.2841", "price_1_20": "270000", "price_20_60": "337500", "promotion_prospective_1_20_cpm": "58.89", "promotion_prospective_20_60_cpm": "73.62", "promotion_prospective_vv": "4584657", "prospective_1_20_cpm": "76.3626", "prospective_20_60_cpm": "95.4533", "province": "上海市", "search_after_view_index_by_industry": "98.99", "sn_expected_play_num": "3535761", "sn_interact_rate_within_30d": "0.033", "sn_play_over_rate_within_30d": "0.2841", "sn_prospective_1_20_cpe": "3.1892", "sn_prospective_1_20_cpm": "76.3626", "sn_prospective_20_60_cpe": "3.9865", "sn_prospective_20_60_cpm": "95.4533", "star_excellent_author": "0", "star_index": "66.53827749888086", "star_qianchuan_high_potential": "0", "star_whispers_author": "0", "tags_relation": "{\"影视娱乐\":[\"明星资讯\"]}", "video_brand_boost": "false", "video_brand_boost_vv": "0" }, "extra_data": { "content_query_from_word": "", "content_query_score": 0, "debug_info": "", "demander_behavior": { "added_author_list": false, "cooperated": false, "viewd_author_page": false }, "recall_from": [ "1_0" ], "recall_return_infos": {}, "recommend_types": [] }, "items": [ { "item_id": "7604417718469233650", "video_tag": 3, "vv": 67750569 } ], "star_id": "6855230644880949262", "task_infos": [ { "online_status": 2, "platform_source": 1, "price_infos": [ { "end_time": "2145916800", "platform_source": 1, "price": 337500, "price_extra_info": {}, "start_time": "1757062015", "task_category": 1, "video_type": 2, "video_type_status": 1 } ], "task_category": 1, "task_status": 1 } ] } ], "base_resp": { "status_code": 0, "status_message": "" }, "extra_data": { "intent_score": 0.6370054483413696, "is_cpm_project_search": false, "is_intent_consistent": true, "search_author_count": 0, "search_item_count": 0, "search_session_id": "7615252989129637942" }, "pagination": { "has_more": true, "limit": 20, "page": 1, "total_count": 10000 } } } } } } }, "x-order": "15002700" } } }, "components": {} }