接口说明

删除视频关键词

使用限制

只有开通了 permission_key 为 open.video.search 的小程序才可以调用
审核中的关键词不可删除

基本信息

名称	描述
HTTP URL	https://open.douyin.com/api/apps/v1/capacity/delete_aweme_video_keyword/
HTTP Method	POST
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

content-type必填String

示例：application/json

固定值"application/json"

Body

keyword_id必填String

示例：7322220691355404332

需要删除的关键词id，必须是审核通过/拒绝的关键词

该字段通过 /api/apps/v1/capacity/query_aweme_video_keyword_list/ 接口返回的 data.keyword_list.0.keyword_id 字段获取

请求示例
curl --location --request POST '/api/apps/v1/capacity/delete_aweme_video_keyword/' \
--header 'content-type: application/json' \
--header 'access-token: isvact.e5ba86fadf731d6a64012ec11e2b4e3d5dq5zKxwG1XO651zQPdb7ebqpZLq' \
--data '{"keyword_id":"7322220691355404332"}'

响应参数

Body

err_msg必填String

示例：success

成功为"success", 错误为具体 message

err_no必填Int32

示例：0

错误码，0 是成功，其它为异常

log_id必填String

示例：202401031934474D5D10CE50349328441E

日志logid

响应示例
正常响应示例异常响应示例
{
  "err_no": 0,
  "err_msg": "success",
  "log_id": "202401031934474D5D10CE50349328441E"
}

切换单列布局

错误码

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

删除视频关键词在线调试