Douyin-App/抖音APP

搜索-获取搜索关键词推荐V2

POST

https://api.getoneapi.com/api/douyin-app/search_suggest_v2

获取抖音搜索关键词的联想推荐结果（V2 版本）。
根据用户已输入的关键词前缀，返回相关搜索词建议，用于实现搜索框实时补全。
返回条数由抖音决定，不支持指定数量。
history_words 为可选项，传入用户此前搜索过的词（英文逗号分隔）会影响联想词排序。
相比 V1，V2 直接给出纯词列表 words，无需再从原始结构中提取。

请求参数

Header 参数

Authorization string 必需

在 Header 添加参数 Authorization，其值为在 Bearer 之后拼接 apikey

默认值： Bearer YOUR_API_KEY

Content-Type string 必需

默认值： application/json

Body 参数

application/json

keyword string 关键词必需

history_words string 可选，历史搜索词可选

示例

{
  "keyword" : "罗永浩",
  "history_words" : ""
}

返回响应

响应 200

application/json

code integer 必需

message string 必需

data object 必需

示例

{
  "code" : 200,
  "message" : "success",
  "data" : {
    "words" : [ "罗永浩年轻时的照片", "罗永浩手机", "罗永浩是干嘛的", "罗永浩没有孩子吗", "罗永浩是谁", "罗永浩脱口秀", "罗永浩大杯超大杯", "罗永浩的十字路口", "罗永浩交个朋友", "罗永浩直播间茶叶" ],
    "items" : [ {
      "pos" : [ {
        "begin" : 0,
        "end" : 2
      } ],
      "content" : "罗永浩年轻时的照片",
      "sug_type" : "",
      "word_record" : {
        "group_id" : "6746395276853908750",
        "words_position" : 0,
        "words_content" : "罗永浩年轻时的照片",
        "words_source" : "sug"
      },
      "extra_info" : {
        "poi_id" : "",
        "poi_location_recall_log_id" : "202611091727037D92C5087E2A9B1B2389",
        "search_params" : "{\"sug_poi_id\":\"\"}"
      }
    }, {
      "pos" : [ {
        "begin" : 0,
        "end" : 2
      } ],
      "content" : "罗永浩手机",
      "sug_type" : "",
      "word_record" : {
        "group_id" : "6579908122054235406",
        "words_position" : 1,
        "words_content" : "罗永浩手机",
        "words_source" : "sug"
      },
      "extra_info" : {
        "poi_id" : "",
        "poi_location_recall_log_id" : "202611091727037D92C5087E2A9B1B2389",
        "search_params" : "{\"sug_poi_id\":\"\"}"
      }
    }, {
      "pos" : [ {
        "begin" : 0,
        "end" : 2
      } ],
      "content" : "罗永浩是干嘛的",
      "sug_type" : "",
      "word_record" : {
        "group_id" : "6604839899168249101",
        "words_position" : 2,
        "words_content" : "罗永浩是干嘛的",
        "words_source" : "sug"
      },
      "extra_info" : {
        "poi_id" : "",
        "poi_location_recall_log_id" : "202611091727037D92C5087E2A9B1B2389",
        "search_params" : "{\"sug_poi_id\":\"\"}"
      }
    }, {
      "pos" : [ {
        "begin" : 0,
        "end" : 2
      } ],
      "content" : "罗永浩没有孩子吗",
      "sug_type" : "",
      "word_record" : {
        "group_id" : "6766306518238237965",
        "words_position" : 3,
        "words_content" : "罗永浩没有孩子吗",
        "words_source" : "sug"
      },
      "extra_info" : {
        "poi_id" : "",
        "poi_location_recall_log_id" : "202611091727037D92C5087E2A9B1B2389",
        "search_params" : "{\"sug_poi_id\":\"\"}"
      }
    }, {
      "pos" : [ {
        "begin" : 0,
        "end" : 2
      } ],
      "content" : "罗永浩是谁",
      "sug_type" : "",
      "word_record" : {
        "group_id" : "6595880903623333128",
        "words_position" : 4,
        "words_content" : "罗永浩是谁",
        "words_source" : "sug"
      },
      "extra_info" : {
        "poi_id" : "",
        "poi_location_recall_log_id" : "202611091727037D92C5087E2A9B1B2389",
        "search_params" : "{\"sug_poi_id\":\"\"}"
      }
    }, {
      "pos" : [ {
        "begin" : 0,
        "end" : 2
      } ],
      "content" : "罗永浩脱口秀",
      "sug_type" : "",
      "word_record" : {
        "group_id" : "6542975529320994055",
        "words_position" : 5,
        "words_content" : "罗永浩脱口秀",
        "words_source" : "sug"
      },
      "extra_info" : {
        "poi_id" : "",
        "poi_location_recall_log_id" : "202611091727037D92C5087E2A9B1B2389",
        "search_params" : "{\"sug_poi_id\":\"\"}"
      }
    }, {
      "pos" : [ {
        "begin" : 0,
        "end" : 2
      } ],
      "content" : "罗永浩大杯超大杯",
      "sug_type" : "",
      "word_record" : {
        "group_id" : "6757172907912205571",
        "words_position" : 6,
        "words_content" : "罗永浩大杯超大杯",
        "words_source" : "sug"
      },
      "extra_info" : {
        "poi_id" : "",
        "poi_location_recall_log_id" : "202611091727037D92C5087E2A9B1B2389",
        "search_params" : "{\"sug_poi_id\":\"\"}"
      }
    }, {
      "pos" : [ {
        "begin" : 0,
        "end" : 2
      } ],
      "content" : "罗永浩的十字路口",
      "sug_type" : "",
      "word_record" : {
        "group_id" : "6862363663991330055",
        "words_position" : 7,
        "words_content" : "罗永浩的十字路口",
        "words_source" : "sug"
      },
      "extra_info" : {
        "poi_id" : "",
        "poi_location_recall_log_id" : "202611091727037D92C5087E2A9B1B2389",
        "search_params" : "{\"sug_poi_id\":\"\"}"
      }
    }, {
      "pos" : [ {
        "begin" : 0,
        "end" : 2
      } ],
      "content" : "罗永浩交个朋友",
      "sug_type" : "",
      "word_record" : {
        "group_id" : "6585116150965769476",
        "words_position" : 8,
        "words_content" : "罗永浩交个朋友",
        "words_source" : "sug"
      },
      "extra_info" : {
        "poi_id" : "",
        "poi_location_recall_log_id" : "202611091727037D92C5087E2A9B1B2389",
        "search_params" : "{\"sug_poi_id\":\"\"}"
      }
    }, {
      "pos" : [ {
        "begin" : 0,
        "end" : 2
      } ],
      "content" : "罗永浩直播间茶叶",
      "sug_type" : "",
      "word_record" : {
        "group_id" : "6845280804671591683",
        "words_position" : 9,
        "words_content" : "罗永浩直播间茶叶",
        "words_source" : "sug"
      },
      "extra_info" : {
        "poi_id" : "",
        "poi_location_recall_log_id" : "202611091727037D92C5087E2A9B1B2389",
        "search_params" : "{\"sug_poi_id\":\"\"}"
      }
    } ],
    "raw_key" : "sug_list"
  }
}

请求示例代码

替换 YOUR_API_KEY、参数占位符与请求数据后使用。第三方客户端需先安装对应依赖。

curl --globoff --request POST 'https://api.getoneapi.com/api/douyin-app/search_suggest_v2' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "keyword" : "罗永浩",
  "history_words" : ""
}'

更新于 2026-11-10 19:04:32