消息服务总线3.0在线接口文档
  1. 2、媒体账号检索相关接口
消息服务总线3.0在线接口文档
  • 1、服务总线-字典接口组
    • 1、国家英文码值对照相关接口
      • 1)国家三字英文码值对照列表
      • 2)根据三字英文码值获取国家名称列表
    • 2、ISO 639语言编码相关接口
      • 1)ISO 639语言编码信息列表
      • 2)指定Code集合获取名称和简称
    • 3、媒体类型相关接口
      • 1)指定境内外类型查询媒体类型【树型结构】
      • 2)指定Code集合获取名称
      • 3)指定Code集合获取字段
      • 4)根据地域查询渠道信息
    • 4、地域相关接口
      • 1)指定区域父级节点查询子集(中国)
      • 2)查询地域树(全国)
      • 3)内容提及查询
      • 4)内容提及-指定区域父级节点查询子集
    • 5、媒体信源标签相关接口
      • 1)媒体标签信息TOP25
      • 2)分页检索媒体标签列表
    • 6、标签相关接口
      • 1)标签根节点列表查询
      • 2)指定标签上一级唯一值查询该标签下子集列表
      • 3)指定标签层级查询该层级下子标签列表
    • 7、分类相关接口
      • 1)分类列表查询
  • 2、消息服务-业务接口组
    • 1、发文检索相关接口
      • 1)分页检索发文信息列表
      • 2)检索发文详情信息
      • 3)通过uuid批量查询发文信息列表
      • 4)相似文章列表查询
      • 5)获取渠道发文转发/评论关系
      • 6)根据文章ID分页获取评论列表
      • 7)Scroll创建接口
      • 8)ScrollID查询接口
      • 9)ScrollID删除接口
      • 10)根据uuid获取OCR信息
      • 11)OCR内容识别
      • 12)相似文章列表查询
    • 2、媒体账号检索相关接口
      • 附件说明
        • 境内账号字段值对应说明
        • 境外账号字段值对应说明
      • 1)分页检索媒体账号信息列表
        POST
      • 2)检索媒体账号详情信息
        POST
      • 3)根据渠道和账号ID查询是否采集该媒体账号信息
        POST
    • 3、发文分析相关接口
      • 1)通用-数据总量获取
      • 2)通用-指定分析字段返回其中某一种聚合分析
      • 3)通用-指定分析字段返回所有聚合分析
      • 4)通用-指定两个分析字段返回其中某一种聚合分析
      • 5)通用-指定字段分析日期直方图聚合
      • 6)通用-指定字段聚合和指定字段排序返回对应Top数据信息
      • 7)通用-数据字段累计求和获取
      • 8)通用-指定两个分析字段分析日期直方图聚合
      • 9)指定语义指纹获取数据量
      • 10)通用-各互动量字段总和获取
      • 11)通用-指定度量字段去重统计
      • 12)通用-指定分析字段返回其中某一种去重统计聚合分析
      • 13)通用-指定分析字段返回COUNT和SUM聚合分析
      • 14)指定渠道和发布时间字段分析日期直方图聚合
    • 4、媒体账号分析相关接口
      • 1)通用-账号总量获取
    • 5、热榜相关接口
      • 附件说明
        • 不同渠道对应同城热榜信息采集情况说明
      • 1)热搜榜信息检索
      • 2)实时热搜榜信息
      • 3)同城-热搜榜信息检索
      • 4)同城-实时热搜榜信息
      • 5)热榜详情信息获取
      • 6)根据榜单类型+渠道实时获取榜单信息
      • 7)根据榜单类型+渠道检索榜单信息
      • 8)境外热榜趋势-指定渠道获取实时热榜趋势信息
      • 9)境外热榜趋势-多条件获取热榜趋势信息
    • 7、数据推送相关接口
      • 1)分页排序多条件检索专题列表查询
      • 2)添加专题信息
      • 3)更新专题信息
      • 4)更新专题状态
      • 5)删除专题信息
      • 6)根据用户ID获取Kafka信息
  • 服务总线-附件
    • Java客户调用接口生成签名工具类
    • Python客户调用接口生成签名工具类
    • 原生服务错误码值说明
  • 产品API
    • 主题订阅
      • 订阅ID
    • 分析组件
      • 事件/话题简介
      • 热点主题
      • 概述
      • 专家观点
      • 信息内容分类
      • 发布地域
      • 发文习惯
      • 媒体曝光趋势对比
      • 媒体等级分布
      • 微博网民观点
      • 提及地域分布
      • 传播路径
      • 账号认证分布
      • 账号性别分布
      • 热点榜单
      • 热点短语
      • 热点词语
      • 情感倾向
      • 热点文章
      • 媒体曝光趋势
      • 影响力指数
      • 互动趋势
      • 热门组织
      • 热门人物
    • AI雷达
      • 主题信息列表
      • 主题信息类型+信息属性
      • 主题信息监测事件列表
  1. 2、媒体账号检索相关接口

1)分页检索媒体账号信息列表

POST
/v1/account/getSearchList
2、媒体账号检索相关接口
多条件筛选查询信息列表结果注意:1、账号信息列表检索展示[最多1万条(含)]           2、若批量拉取数据,使用gid排序并升序asc

请求参数

Header 参数
appKey
AppKey
必需
nonce
随机数
必需
timestamp
时间戳
必需
signature
必需
签名,详见附件客户签名生成工具类
Body 参数application/json
账号检索入参
dataSources
array[string]
可选
媒体类型,详见《字典接口模块》指定境内外类型查询媒体类型接口【取返回结果code字段值】
示例值:
["00101"]
userIds
array[string]
可选
账号ID【网站、电子报纸没有】,最多支持20个(包含20,总长度300)
userNames
array[string]
可选
账号名称【网站、电子报纸、客户端没有,想要查询使用websiteNames字段】,最多支持20个(包含20,总长度300)
websiteNames
array[string]
可选
站点名称【网站-人民网、快手-快手】,最多支持20个(包含20,总长度300)
示例值:
["人民网"]
subWebsiteNames
array[string]
可选
子站名称【网站】,最多支持20个(包含20,总长度300)
示例值:
["人民网-山西"]
channelNames
array[string]
可选
频道名称【网站、论坛百度贴吧等相关数据有该字段】,最多支持20个(包含20,总长度300)
示例值:
["反腐"]
url
string 
账号主页链接
可选
示例值:
http://sx.people.com.cn/GB/353623/index.html
hosts
array[string]
一级域名
可选
示例值:
["pku.edu.cn"]
subHosts
array[string]
二级域名
可选
示例值:
["pku.edu.cn"]
ipAreaCountries
array[string]
可选
IP属地国家,详见《字典接口模块》国家三字英文码值对照列表【取返回结果pek字段值】
ipAreaProvinces
array[string]
可选
IP属地省份,详见《字典接口模块》指定区域父级节点查询子集(中国)【取返回结果id字段值】
accountMatchDTO
object (AccountMatch) 
可选
自定义匹配方式入参注意:支持根据站点名称、账号名称等六个字段进行检索明确需求,需要用到哪些字段,匹配的字段越少越好,否则浪费系统资源!账号匹配方式matchType可以对输入的关键词进行精确匹配或模糊匹配默认操作符defaultOperator可以决定不同关键词间的关系是and或or
matchType
integer <int32>
可选
账号匹配方式【0-精确匹配、1-模糊匹配】
>= 0<= 1
示例值:
0
defaultOperator
integer <int32>
可选
默认操作符【空/0默认AND、1-OR】
>= 0<= 1
示例值:
1
websiteNames
string 
可选
站点名称【支持关键词长度最大100】
subWebsiteNames
string 
可选
子站点名称【支持关键词长度最大100】
userNames
string 
可选
账号名称【支持关键词长度最大100】
authors
string 
可选
作者【支持关键词长度最大100】
userIds
string 
可选
账号ID【支持关键词长度最大100】
channelNames
string 
可选
站点渠道名称【支持关键词长度最大100】
customId
string 
可选
个性化账号id【支持关键词长度最大100】
secUid
string 
可选
用户第二uid【支持关键词长度最大100】,账号检索可用,发文检索不可用
host
string 
可选
域名【支持关键词长度最大100】
verifiedTypes
array[integer <int32>]
可选
认证类型【0-未认证、1-个人、2-机构组织、3-公司企业、4-其他】
enable
integer <int32>
可选
账号是否有效【为空/-1(全部),0-无效、1-有效】
>= -1<= 1
默认值:
-1
status
integer <int32>
可选
账号采集状态【为空/-1(全部)、0-废弃、1-采集】
>= -1<= 1
默认值:
-1
isCollectComment
integer <int32>
可选
是否采集评论【为空/-1(全部)、0-不采集、1-采集】
>= -1<= 1
默认值:
-1
isUpdateInteraction
integer <int32>
可选
是否更新互动量【为空/-1(全部)、0-不更新、1-更新】
>= -1<= 1
默认值:
-1
isStandardCollect
integer <int32>
可选
是否标准采集【为空/-1(全部)、0-非标准、1-标准】
>= -1<= 1
默认值:
-1
isForeignMedia
integer <int32>
可选
是否境内外媒体【0-境内、1-境外(外国媒体+港澳台媒体)、空/-1-境内外(全部)】
>= -1<= 1
默认值:
-1
country
array[string]
可选
媒体国家,详见《字典接口模块》国家三字英文码值对照列表【取返回结果pek字段值】
默认值:
CHN
accountAreas
array[object (AccountArea) {4}] 
可选
媒体地域信息,详见《字典接口模块》指定区域父级节点查询信息或者查询地域树(全国)【取返回结果id字段值】
accountAreaProvince
string 
账号所在省份
可选
默认值:
11
accountAreaCity
string 
账号所在市
可选
默认值:
110100000000
accountAreaCounty
string 
账号所在区|县
可选
默认值:
110102000000
allParamsEmpty
boolean 
可选
mediaTags
array[string]
可选
媒体标签,详见《字典接口模块》媒体信源标签信息列表【取返回结果tagName字段值】,最多支持20个(包含20,总长度100)注意:articlePlatform.mediaTags与articlePlatform.excludeMediaTags字段同时有值,articlePlatform.excludeMediaTags不会生效不能同时存在,其中一个可不传
excludeMediaTags
array[string]
可选
排除媒体标签,详见《字典接口模块》媒体信源标签信息列表【取返回结果tagName字段值】,最多支持20个(包含20,总长度100)注意:articlePlatform.mediaTags与articlePlatform.excludeMediaTags字段同时有值,articlePlatform.excludeMediaTags不会生效不能同时存在,其中一个可不传
mediaTypes
array[integer <int32>]
可选
站点级别【为空-全部、1-站点、2-频道、3-账号、4-群组】
hostType
integer <int32>
可选
站点级别【为空-全部、1-主域名、2-子域名】
>= 1<= 2
insertTime
object (InsertTime) 
数据入队列时间
可选
startInsertTime
string 
可选
示例值:
yyyy-MM-dd HH:mm:ss
endInsertTime
string 
可选
示例值:
yyyy-MM-dd HH:mm:ss
updateTime
object (UpdateTime) 
数据更新时间
可选
startUpdateTime
string 
可选
示例值:
yyyy-MM-dd HH:mm:ss
endUpdateTime
string 
可选
示例值:
yyyy-MM-dd HH:mm:ss
areaType
string 
可选
IP归属地所在国家+IP归属地所在省+媒体国家+媒体地域信息构建关系【默认AND关系,1-AND、2-OR】
示例值:
1
pageInfo
object (BasePage) 
可选
分页信息【最大可查前一万条数据(页数*每页条数不可大于一万条)】
currentPage
integer <int32>
可选
当前页【默认第一页】
>= 1
默认值:
1
pageSize
integer <int32>
可选
每页条数【默认每页10条,最大200条】
>= 1<= 200
默认值:
10
sortInfo
object (AccountBaseSort) 
账号基础排序对象
可选
sortField
integer <int32>
可选
排序类型【默认插入时间排序,9-插入时间、10-相关度排序、11-更新时间、12-粉丝总数、13-Gid排序、14-标签等级、15-数据入ES时间】
>= 9<= 15
默认值:
9
sortWay
string 
可选
排序方式【默认倒序,asc-正序、desc-倒序】
默认值:
desc
s
array[integer <int32>]
可选
示例
{
  "dataSources": [
    "esse eu nostrud et id"
  ],
  "userIds": [
    "ut minim cillum"
  ],
  "userNames": [
    "cillum"
  ],
  "websiteNames": [
    "qui sunt ut Duis ullamco"
  ],
  "subWebsiteNames": [
    "amet nulla incididunt laborum quis"
  ],
  "channelNames": [
    "ipsum"
  ],
  "url": "nulla ea minim Excepteur officia",
  "hosts": [
    "incididunt officia elit"
  ],
  "subHosts": [
    "in Excepteur veniam velit"
  ],
  "ipAreaCountries": [
    "ex aliqua"
  ],
  "ipAreaProvinces": [
    "ut"
  ],
  "accountMatchDTO": {
    "matchType": 1,
    "defaultOperator": 1,
    "websiteNames": "ut",
    "subWebsiteNames": "deserunt in qui",
    "userNames": "Excepteur",
    "authors": "deserunt voluptate mollit",
    "userIds": "mollit",
    "channelNames": "ad est commodo Duis",
    "customId": "aute minim",
    "secUid": "sit sint",
    "host": "Excepteur officia Ut sunt"
  },
  "verifiedTypes": [
    -98215004
  ],
  "enable": -1,
  "status": -1,
  "isCollectComment": -1,
  "isUpdateInteraction": 1,
  "isStandardCollect": -1,
  "isForeignMedia": 0,
  "country": [
    "sint dolore"
  ],
  "accountAreas": [
    {
      "accountAreaProvince": "Duis proident nisi Lorem reprehenderit",
      "accountAreaCity": "do",
      "accountAreaCounty": "in enim laboris veniam ea",
      "allParamsEmpty": true
    }
  ],
  "mediaTags": [
    "quis veniam"
  ],
  "excludeMediaTags": [
    "labore dolor"
  ],
  "mediaTypes": [
    -1092541
  ],
  "hostType": 2,
  "insertTime": {
    "startInsertTime": "veniam labore ut ea dolore",
    "endInsertTime": "laboris sed sint esse"
  },
  "updateTime": {
    "startUpdateTime": "aute irure",
    "endUpdateTime": "amet commodo exercitation do"
  },
  "areaType": "sint mollit ut",
  "pageInfo": {
    "currentPage": 24047159,
    "pageSize": 142
  },
  "sortInfo": {
    "sortField": 13,
    "sortWay": "tempor aliquip velit enim"
  },
  "s": [
    -77758976
  ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/v1/account/getSearchList' \
--header 'appKey;' \
--header 'nonce;' \
--header 'timestamp;' \
--header 'signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "dataSources": [
        "esse eu nostrud et id"
    ],
    "userIds": [
        "ut minim cillum"
    ],
    "userNames": [
        "cillum"
    ],
    "websiteNames": [
        "qui sunt ut Duis ullamco"
    ],
    "subWebsiteNames": [
        "amet nulla incididunt laborum quis"
    ],
    "channelNames": [
        "ipsum"
    ],
    "url": "nulla ea minim Excepteur officia",
    "hosts": [
        "incididunt officia elit"
    ],
    "subHosts": [
        "in Excepteur veniam velit"
    ],
    "ipAreaCountries": [
        "ex aliqua"
    ],
    "ipAreaProvinces": [
        "ut"
    ],
    "accountMatchDTO": {
        "matchType": 1,
        "defaultOperator": 1,
        "websiteNames": "ut",
        "subWebsiteNames": "deserunt in qui",
        "userNames": "Excepteur",
        "authors": "deserunt voluptate mollit",
        "userIds": "mollit",
        "channelNames": "ad est commodo Duis",
        "customId": "aute minim",
        "secUid": "sit sint",
        "host": "Excepteur officia Ut sunt"
    },
    "verifiedTypes": [
        -98215004
    ],
    "enable": -1,
    "status": -1,
    "isCollectComment": -1,
    "isUpdateInteraction": 1,
    "isStandardCollect": -1,
    "isForeignMedia": 0,
    "country": [
        "sint dolore"
    ],
    "accountAreas": [
        {
            "accountAreaProvince": "Duis proident nisi Lorem reprehenderit",
            "accountAreaCity": "do",
            "accountAreaCounty": "in enim laboris veniam ea",
            "allParamsEmpty": true
        }
    ],
    "mediaTags": [
        "quis veniam"
    ],
    "excludeMediaTags": [
        "labore dolor"
    ],
    "mediaTypes": [
        -1092541
    ],
    "hostType": 2,
    "insertTime": {
        "startInsertTime": "veniam labore ut ea dolore",
        "endInsertTime": "laboris sed sint esse"
    },
    "updateTime": {
        "startUpdateTime": "aute irure",
        "endUpdateTime": "amet commodo exercitation do"
    },
    "areaType": "sint mollit ut",
    "pageInfo": {
        "currentPage": 24047159,
        "pageSize": 142
    },
    "sortInfo": {
        "sortField": 13,
        "sortWay": "tempor aliquip velit enim"
    },
    "s": [
        -77758976
    ]
}'

返回响应

🟢200OK
application/json
Body
返回数据格式
code
integer <int32>
可选
响应码【200代表成功,其他参见错误码值表】)
success
boolean 
可选
是否成功【true代表成功,false代表失败】
message
string 
响应消息
可选
data
object (PageDocListAccountResultVO) 
分页响应参数
可选
list
array[object (AccountResultVO) {41}] 
数据结果
可选
totalPages
integer <int32>
可选
总页码数【注意:为了提升性能会提前截断返回,导致不准确,需要自己根据数据总数/每页展示条数计算得出】
totalElements
integer <int64>
可选
数据总数【注意:为了提升性能会提前截断返回,导致不准确;若想获取准确结果:参考:发文分析相关接口->通用数据总量获取】
sortValues
array [object] 
排序相关信息
可选
currentPage
integer <int32>
当前页码
可选
pageSize
integer <int32>
每页展示条数
可选
errors
array[string]
错误信息集合
可选
time
string <date-time>
响应时间
可选
示例
{
  "code": 0,
  "success": true,
  "message": "string",
  "data": {
    "list": [
      {
        "uuid": "string",
        "userId": "string",
        "customId": "string",
        "secUid": "string",
        "userName": "string",
        "nickName": "string",
        "url": "string",
        "secUrl": "string",
        "description": "string",
        "headImageUrl": "string",
        "likeCount": 0,
        "favouriteCount": 0,
        "playCount": 0,
        "followersCount": 0,
        "publishCount": 0,
        "followCount": 0,
        "collectCount": 0,
        "rttCount": 0,
        "friendsCount": 0,
        "registrationTime": "2019-08-24T14:15:22Z",
        "gender": "string",
        "birthday": "2019-08-24T14:15:22Z",
        "age": 0,
        "verifiedType": 0,
        "verifiedInfo": "string",
        "mcn": "string",
        "ipAreaName": "string",
        "ipAreaCountry": "string",
        "ipAreaProvince": "string",
        "location": "string",
        "country": "string",
        "province": "string",
        "city": "string",
        "county": "string",
        "isForeignMedia": 0,
        "insertTime": "string",
        "updateTime": "string",
        "gid": 0,
        "platform": {
          "dataSourceType": "string",
          "websiteName": "string",
          "host": "string",
          "subHost": "string",
          "channelName": "string",
          "mediaType": 0,
          "hostType": 0,
          "chineseName": "string",
          "subWebsiteName": "string",
          "chineseSubName": "string",
          "chineseChannelName": "string",
          "multipleHosts": [
            "string"
          ],
          "nameAlias": [
            "string"
          ]
        },
        "crawler": {
          "enable": 0,
          "status": 0,
          "priority": 0,
          "tags": [
            "string"
          ],
          "collectComment": 0,
          "renewInteraction": 0,
          "standardCollect": 0,
          "period": 0,
          "s": 0
        },
        "esInsertTime": "string"
      }
    ],
    "totalPages": 0,
    "totalElements": 0,
    "sortValues": [
      {}
    ],
    "currentPage": 0,
    "pageSize": 0
  },
  "errors": [
    "string"
  ],
  "time": "2019-08-24T14:15:22Z"
}
上一页
境外账号字段值对应说明
下一页
2)检索媒体账号详情信息
Built with