{
  "openapi": "3.0.0",
  "info": {
    "title": "抖音巨量星图KOL 关键词搜索 API (V1)",
    "version": "1.0.0",
    "description": "获取抖音巨量星图KOL关键词搜索数据，包括匹配创作者和发现数据，用于创作者来源和建立候选名单。"
  },
  "paths": {
    "/api/douyin-xingtu/search-kol-simple/v1": {
      "get": {
        "tags": [
          "抖音巨量星图"
        ],
        "summary": "KOL 关键词搜索",
        "description": "获取抖音巨量星图KOL关键词搜索数据，包括匹配创作者和发现数据，用于创作者来源和建立候选名单。",
        "operationId": "searchKolSimpleV1",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "description": "用户鉴权令牌。",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "description": "搜索关键词。",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "platformSource",
            "in": "query",
            "description": "平台来源。\n\n可用值：\n- `_1`: 抖音\n- `_2`: 头条\n- `_3`: 西瓜",
            "required": true,
            "schema": {
              "type": "string",
              "description": "KOL search platform source",
              "enum": [
                "_1",
                "_2",
                "_3"
              ]
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "页码。",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "acceptCache",
            "in": "query",
            "description": "启用缓存。",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "default": {
            "description": "默认响应",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "data": {
                    "authors": [
                      {
                        "attribute_datas": {
                          "assign_cpm_suggest_price": "97",
                          "author_avatar_frame_icon": "0",
                          "author_ecom_level": "L1",
                          "author_level_game": "Lv1",
                          "author_level_other": "Lv1",
                          "author_status": "1",
                          "author_thin_mid_word_association_index": "{\"清爽\":0.001,\"美白\":0,\"胶原成分\":0,\"防晒\":0}",
                          "author_type": "3",
                          "avatar_uri": "https://p11.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_b599131429f4663d0aefe659daad0...",
                          "brand_boost_vv": "52097",
                          "city": "杭州市",
                          "content_theme_labels_180d": "[\"个人成长\",\"保暖穿搭\",\"零食测评\",\"消费体验\",\"羽绒服穿搭\",\"口红测评\",\"健康养生\",\"秋冬穿搭\",\"护发技巧\",\"体重管理\"]",
                          "core_user_id": "93237932151",
                          "e_commerce_enable": "1",
                          "ecom_avg_order_value_30d_range": "50-200",
                          "ecom_gmv_30d_range": "1k-3w",
                          "ecom_gpm_30d_range": "<=80",
                          "ecom_score": "82",
                          "ecom_video_ctr_30d_range": "8%-10%",
                          "ecom_video_mid_click_pv_30d_range": "500以下",
                          "ecom_video_product_num_30d": "4",
                          "enroll_task_price_list": "[15000]",
                          "expected_cpa3_level": "4",
                          "expected_natural_play_num": "11360",
                          "expected_play_num": "15219",
                          "fans_increment_rate_within_15d": "-0.0025303994312070445",
                          "fans_increment_within_15d": "-694",
                          "fans_increment_within_30d": "-1533",
                          "follower": "273517",
                          "game_type": "",
                          "gender": "2",
                          "grade": "0",
                          "id": "6978702114235088932",
                          "interact_rate_within_30d": "0.0286",
                          "interaction_median_30d": "256",
                          "is_ad_star_cur_high_quality_author": "0",
                          "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\":\"31\",\"is_high_quality_item\":\"0\",\"item_create_time\":\"1772459830\",\"item_id\":\"761265693...",
                          "link_convert_index": "77.48",
                          "link_convert_index_by_industry": "77.48",
                          "link_i_cnt_by_industry": "101664",
                          "link_k_cnt_by_industry": "131",
                          "link_l_cnt_by_industry": "303648",
                          "link_link_cnt_by_industry": "497272",
                          "link_n_cnt_by_industry": "91829",
                          "link_recommend_index_by_industry": "60.63",
                          "link_shopping_index": "60.63",
                          "link_spread_index": "63.3",
                          "link_spread_index_by_industry": "63.3",
                          "link_star_index": "70.24",
                          "link_star_index_by_industry": "70.24",
                          "link_user_type_by_industry": "2",
                          "local_lower_threshold_author": "false",
                          "nick_name": "中年美妆博母杨光",
                          "pic_expected_play_num": "0",
                          "play_over_rate_within_30d": "0.0641",
                          "price_1_20": "24000",
                          "price_20_60": "27000",
                          "price_60": "28000",
                          "promotion_prospective_1_20_cpm": "1764.19",
                          "promotion_prospective_20_60_cpm": "1984.71",
                          "promotion_prospective_60_cpm": "2058.22",
                          "promotion_prospective_vv": "13604",
                          "prospective_1_20_cpm": "1576.9761",
                          "prospective_20_60_cpm": "1774.0982",
                          "prospective_60_cpm": "1839.8055",
                          "province": "浙江省",
                          "search_after_view_index_by_industry": "87.06",
                          "sn_expected_play_num": "15219",
                          "sn_interact_rate_within_30d": "0.0286",
                          "sn_play_over_rate_within_30d": "0.0641",
                          "sn_prospective_1_20_cpe": "78.6885",
                          "sn_prospective_1_20_cpm": "1576.9761",
                          "sn_prospective_20_60_cpe": "88.5246",
                          "sn_prospective_20_60_cpm": "1774.0982",
                          "sn_prospective_60_cpe": "91.8033",
                          "sn_prospective_60_cpm": "1839.8055",
                          "star_ecom_video_num_30d": "0",
                          "star_excellent_author": "0",
                          "star_index": "81.2509603142163",
                          "star_qianchuan_high_potential": "0",
                          "star_whispers_author": "0",
                          "tags_relation": "{\"时尚\":[\"穿搭\"]}",
                          "video_brand_boost": "true",
                          "video_brand_boost_vv": "52097",
                          "vv_median_30d": "13379"
                        },
                        "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": "7580711922930502073",
                            "video_tag": 3,
                            "vv": 3224450
                          }
                        ],
                        "star_id": "6978702114235088932",
                        "task_infos": [
                          {
                            "online_status": 1,
                            "platform_source": 1,
                            "price_infos": [
                              {
                                "end_time": "2145916800",
                                "platform_source": 1,
                                "price": 15000,
                                "price_extra_info": {},
                                "start_time": "1682870400",
                                "task_category": 1,
                                "video_type": 73,
                                "video_type_status": 1
                              }
                            ],
                            "task_category": 1,
                            "task_status": 1
                          }
                        ]
                      }
                    ],
                    "base_resp": {
                      "status_code": 0,
                      "status_message": ""
                    },
                    "extra_data": {
                      "is_cpm_project_search": false,
                      "search_author_count": 0,
                      "search_item_count": 0,
                      "search_session_id": "7615253138564218918"
                    },
                    "pagination": {
                      "has_more": true,
                      "limit": 20,
                      "page": 1,
                      "total_count": 4385
                    }
                  }
                }
              }
            }
          }
        },
        "x-order": "15003700"
      }
    }
  },
  "components": {}
}