提交热词分析任务
更新时间：2026-03-20 11:10:36
API测试
申请API调用
基本信息
接口描述：由用户根据需求来提交热词分析任务。任务提交成功后就可以通过分析结果查询接口来查询对应专题的分析结果。
请求方式：post
请求地址：
analyze/hotword/task/create
请求参数格式：application/json
输入参数
参数名称
类型
是否必填
描述
taskName
string
是
任务名称
startDate
string
是
分析任务的开始时间（格式为yyyyMMdd）
endDate
string
是
分析任务的结束时间（格式为yyyyMMdd），不在时间范围内的任务不分析
siteName
string
否
站点名称，多个站点名称使用“,”分隔。参数限制：多个参数时数量不超过10个；参数值总长度50个字符以内
channel
string
否
频道名称，多个名称使用“,”分隔。参数限制：多个参数时数量不超过10个；参数值总长度50个字符以内
mediaUnitName
string
否
站点所属的集团名称，多个集团名称使用“,”分隔。参数限制：多个参数时数量不超过10个；参数值总长度50个字符以内
mediaLevel
string
否
媒体等级：核心、一级、二级
groupQueryParam
string
否
组合条件输入参数，复杂的条件组合可以使用该条件，详情见接口示例
输出参数
参数名称
类型
描述
code
string
接口状态码，200为正常，其他为错误码
msg
string
接口的错误描述信息
data
string
接口内的具体返回信息
id
String
任务的id，后面可以根据id查询对应的结果信息
requestid
string
当前请求的唯一ID，反馈问题时直接提交此信息
调用示例
http://[域名]/opens/api/analyze/hotword/task/create
输入示例
{
"taskName":"测试热词任务",
"startDate":"20210601",
"endDate":"20210618",
"contentAreaCatalog":"北京",
"mediaAreaCatalog":"福建",
"groupQueryParam":[
{
"query":"groupQuery",
"groupQuery":[
{
"groupRelation":"AND",
"relation":"OR",
"query":"title,content",
"value":"两会;人大",
"valueRelation":"AND"
},
{
"groupRelation":"AND",
"relation":"AND",
"query":"title",
"value":"人民代表;报告",
"valueRelation":"OR"
},
{
"groupRelation":"AND",
"relation":"OR",
"query":"content",
"value":"大会;协商会议",
"valueRelation":"OR"
}
]
},
{
"query":"groupQuery",
"groupQuery":[
{
"groupRelation":"AND",
"relation":"OR",
"query":"title,content",
"value":"测试2;测试222;",
"valueRelation":"AND"
},
{
"groupRelation":"AND",
"relation":"AND",
"query":"title",
"value":"2222222两会;人大;政协;人民代表大会;政府工作报告;政治协商会议",
"valueRelation":"OR"
},
{
"groupRelation":"NOT",
"relation":"OR",
"query":"content",
"value":"22222222222222两会;人大;政协;人民代表大会;政府工作报告;政治协商会议",
"valueRelation":"OR"
}
]
}
]
}
输出示例
{
"code": 200,
"msg": "请求成功",
"data": {
"id": 7 //此次提交任务的id
},
"requestid": "cd9b359543d948b2b34afd172b7e97b3"
}
接口说明
groupQueryParam参数说明： 1.创建专题是关键词三个为一组（即必须关键词，包含关键词，排除关键词），其中必须关键词，包含关键词必须包含其中一个 2.groupQueryParamStr为组合关键词参数用于复杂条件使用，最多可添加10组，groupQuery为一组关键词条件（即必须关键词，包含关键词，排除关键词三种类型），其中必须关键词，包含关键词必须包含其中一个 一组条件中包含参数说明： “groupRelation”：标识当前条件和其他条件直接的关系（组内多个条件之间关系），为空否则无效，支持and|AND、or|OR、not|NOT等 “relation”：标识查询字段多值之间的关系，为空否则无效，支持and|AND、or|OR等。 “query”：为支持的查询字段多值逗号分隔，为空否则无效(title|content|title,content其中title代表标题，content代表正文)，groupQuery为保留字段表示一个组合查询。 “value”：为查询的值（多值半角分号隔开），为空否则无效(长度限制为字符数0~500)。 “valueRelation”:如果是多值查询，用于指定多值之间的关系，and|AND、or|OR。
在线测试
请求方式：
POST
*taskName：
*startDate：
*endDate：
siteName：
channel：
mediaUnitName：
language：
mediaType：
mediaLevel：
mediaAdministrationType：
mediaIndustryCatalog：
mediaAreaCatalog：
contentAreaCatalog：
contentIndustryCatalog：
groupQueryParam：
确定
重置
请求结果
错误码
其他错误码详见
公共错误码。