{
  "openapi": "3.0.0",
  "info": {
    "title": "抖音用户搜索 API (V2)",
    "version": "1.0.0",
    "description": "获取抖音用户搜索数据，包括档案元数据和粉丝信号，用于创作者发现和账号研究。"
  },
  "paths": {
    "/api/douyin/search-user/v2": {
      "get": {
        "tags": [
          "抖音"
        ],
        "summary": "用户搜索",
        "description": "获取抖音用户搜索数据，包括档案元数据和粉丝信号，用于创作者发现和账号研究。",
        "operationId": "searchUserV2",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "description": "此 API 服务的访问令牌。",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "description": "搜索关键词。",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "页码（从1开始）。",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "userType",
            "in": "query",
            "description": "按用户类型筛选。\n\n可用值：\n- `common_user`: 普通用户\n- `enterprise_user`: 企业用户\n- `personal_user`: 已认证个人用户",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Douyin - User Search Type Filter",
              "enum": [
                "common_user",
                "enterprise_user",
                "personal_user"
              ]
            }
          }
        ],
        "responses": {
          "default": {
            "description": "默认响应",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "data": {
                    "business_data": [
                      {
                        "data_id": "0",
                        "type": 999,
                        "data": {
                          "tab": null,
                          "debug_data": {
                            "filter_debug_info_list": null
                          },
                          "card_type": 4,
                          "type": 999,
                          "schema": "aweme://lynxview/?channel=morphling_high&bundle=channel_user%2Findex%2Ftemplate.js&group=morphling_h...",
                          "log_data": {
                            "dcm": "search.natural.discover.105246634576.20260309224145DCBF940783D6EB76DF04"
                          },
                          "ecom_goods_list": null,
                          "music_info_list": null,
                          "ops": null,
                          "height": 80,
                          "doc_type": 150,
                          "provider_doc_id_str": "105246634576",
                          "aweme_list": null,
                          "card_style_type": 4,
                          "card_protocal_struct": {
                            "render_type": 1,
                            "render_extra": {
                              "type": 999,
                              "card_type_name": "channel_user",
                              "schema": "aweme://lynxview/?channel=morphling_high&bundle=channel_user%2Findex%2Ftemplate.js&group=morphling_h...",
                              "height": 80
                            }
                          },
                          "qishui_music_list": null,
                          "shoot_position_list": null,
                          "origin_type": 4,
                          "provider_doc_id": 105246634576,
                          "show_tab": null,
                          "debug_diff_info": {},
                          "send_back": "",
                          "sub_card_list": null,
                          "card_id": "douyin.doctype_aweme_user",
                          "raw_data": "{\"is_red_uniqueid\":false,\"is_private_letter\":null,\"is_red_phone_number\":null,\"phone_number_encrypted...",
                          "card_type_name": "channel_user"
                        },
                        "log": {
                          "dcm": "search.natural.discover.105246634576.20260309224145DCBF940783D6EB76DF04"
                        },
                        "card_id": "douyin.doctype_aweme_user"
                      }
                    ],
                    "render_info": [
                      {
                        "render_id": "0",
                        "render_type": 1,
                        "render_extra": {
                          "card_type_name": "channel_user",
                          "type": 999,
                          "schema": "aweme://lynxview/?channel=morphling_high&bundle=channel_user%2Findex%2Ftemplate.js&group=morphling_h...",
                          "height": 80
                        },
                        "ui_info": null
                      }
                    ],
                    "struct": {
                      "id": "00",
                      "layout_type": 1,
                      "children": [
                        {
                          "id": "0",
                          "data_id": "0",
                          "render_id": "0",
                          "fp": ""
                        }
                      ],
                      "fp": ""
                    },
                    "business_config": {
                      "keyword": "小德MOMO",
                      "has_more": 1,
                      "is_filter_search": 1,
                      "search_nil_info": null,
                      "next_page": {
                        "keyword": "小德MOMO",
                        "search_request_id": "20260309224145DCBF940783D6EB76DF04",
                        "search_id": "20260309224145DCBF940783D6EB76DF04",
                        "cursor": 20,
                        "poi_search_info": ""
                      },
                      "card_count": 19,
                      "extra_fresh_struct": null,
                      "ad_info": null,
                      "filter_bar": null,
                      "extra": {
                        "hidden_filter": false,
                        "req_start_ts": 1773067305361,
                        "is_filter_search": 1
                      },
                      "feedback": {
                        "url": "aweme://webview/?url=https%3A%2F%2Faweme.snssdk.com%2Ffalcon%2Ffe_app_react%2Fquestionnaire%2Findex....",
                        "text_first": "找不到想找的帐号？",
                        "text_second": "告诉我们"
                      },
                      "pre_loadmore_config": null,
                      "poi_search_info": ""
                    },
                    "global_config": {
                      "hidden_filter": false
                    },
                    "status_code": 0,
                    "log_pb": {
                      "impr_id": "20260309224145DCBF940783D6EB76DF04"
                    },
                    "extra": {
                      "now": 1773067306000,
                      "logid": "20260309224145DCBF940783D6EB76DF04",
                      "fatal_item_ids": [],
                      "search_request_id": "",
                      "device_score": 0,
                      "scenes": null
                    },
                    "log": {
                      "search_id": "20260309224145DCBF940783D6EB76DF04",
                      "impr_id": "20260309224145DCBF940783D6EB76DF04",
                      "search_keyword": "小德MOMO"
                    },
                    "time_cost": {
                      "stream_inner": 694
                    },
                    "path": "/aweme/v2/search/discover/",
                    "mock_recall_path": "/aweme/v2/search/discover/",
                    "success": true
                  }
                }
              }
            }
          }
        },
        "x-order": "14001500"
      }
    }
  },
  "components": {}
}