接口说明

查询视频关键词列表

使用限制

只有开通了 permission_key 为 open.video.search 权限的小程序才可以调用

基本信息

名称	描述
HTTP URL	https://open.douyin.com/api/apps/v1/capacity/query_aweme_video_keyword_list/
HTTP Method	GET
Scope	video.keywords.admin
权限要求	服务商代调用场景下，需商家授予运营管理权限集视频关键词管理

请求参数

请求头

access-token必填String

当非服务商时，调用https://open.douyin.com/oauth/client_token/生成的token
当服务商时，调用https://open.douyin.com/api/tpapp/v2/auth/get_auth_token/生成的token

Query

page_num必填Int32

示例：1

分页编号，从 1 开始

page_size必填Int32

示例：10

分页大小，小于等于 20

请求示例
curl --location --request GET '/api/apps/v1/capacity/query_aweme_video_keyword_list/?page_num=1&page_size=10' \
--header 'access-token: isvact.e5ba86fadf731d6a64012ec11e2b4e3d5dq5zKxwG1XO651zQPdb7ebqpZLq' \

响应参数

Body展开全部子属性

err_msg必填String

示例：success

错误描述

err_no必填Int32

示例：0

错误码

log_id必填String

示例：2024011015024199446EA8194F3ECF5193

日志logid

dataStruct

展开子属性

响应示例
正常响应示例异常响应示例
{
  "err_no": 0,
  "log_id": "2024011015024199446EA8194F3ECF5193",
  "data": {
    "keyword_list": [
      {
        "keyword": "test",
        "keyword_id": "7322220691355404332",
        "status": 0
      }
    ],
    "total_count": 1
  },
  "err_msg": "success"
}

切换单列布局

错误码

HTTP 状态码	错误码	错误码描述	排查建议
200	-1	系统错误	建议重试
200	11001	appid无法解析	建议重试
200	11009	参数不合法或缺少参数	检查参数合法性
200	11016	access_token不正确或者已过期	检查access_token合法性
200	40006	非法请求，请求 IP 不在第三方小程序应用 IP 地址白名单内	添加IP地址到白名单内或者配置白名单为空
200	40036	授权小程序未授予该接口对应的权限	引导商家授予相关权限集

查询视频关键词列表在线调试