diamond.pangqiu.queryLiveRoomData

  • 免费
  • 需要授权
  • 结果不加密
直播间对外(胖球)数据明细表

公共参数

名称 类型 必选 描述
app_key Long 接入时申请的app_key
method String 接口名称
access_token String Oauth2.0授权获得的access_token
sign String 对 API 调用参数(除sign外)进行 md5 加密获得。参数的顺序为字母表的顺序
timestamp Long 时间戳,使用Unix时间戳格式
format String 响应格式。默认为json格式,固定
sign_method String 参数的加密方法选择,当前只支持Md5
version String API协议版本,固定值为:1.0

输入参数

名称 类型 必选 描述 示例值
query
Object 查询主播对外数据参数对象
minId
Number 最小序号ID 0
pageSize
Number 每页查询数量 10
startDate
String 直播日期 2021-09-02

返回参数

名称 类型 描述 默认值
value
Object 响应值
data
Object[] 响应数据列表
data_object
Object 响应数据项
id
Number 序号ID 0
liveId
Number 直播间id 0
liveTitle
String 直播间标题
liveImage
String 直播间封面
liveStartTime
String 直播开始时间(单位:秒) 1630585215
liveEndTime
String 直播结束时间(单位:秒) 1630593877
liveDuration
Number 直播时长(单位:秒) 0
liveItemNum
Number 直播商品个数 0
liveSoldNum
Number 直播商品件数 0
liveGmv
Number 直播商品gmv(单位:元) 0
actorId
Number 主播id 0
actorName
String 主播名
actorGender
String 主播性别
actorPower
String 主播种草力(数值)
actorLevel
String 主播等级(0,10,20,30,40,50,60,70,80,90,100 eg:100表示K10等级 )
actorFansNum
Number 主播粉丝个数 0
actorOrderNum
Number 主播关注个数 0
actorDesc
String 主播简介
actorLocation
String 主播所在地(所在城市)
actorReputation
Number 主播口碑(三位数字,例如:325,主播口碑透出3.25) 0
liveHours
String 主播直播时段(主播30日开播时段分布,比如:[16:1,9:17] 表示16点点1次,9点的17次)
itemId
Number 直播商品id 0
itemName
String 商品名
itemImage
String 商品图片
itemBrand
String 商品品牌
itemStartTime
String 添加售货袋时间(格式:2021-08-25 19:32:47)
itemEndTime
String 直播结束时间(格式:2021-08-25 19:32:47)
itemPrice
Number 商品售货价 0
itemSoldNum
Number 商品成交件数 0
itemRootId
Number 站内一级类目id 0
itemRootName
String 站内一级类目名(例如:食品)
itemSecondId
Number 站内二级类目id 0
itemSecondName
String 站内二级类目名(例如:茶/咖啡/冲饮/酒类)
itemThirdId
Number 站内三级类目id 0
itemThirdName
String 站内三级类目名(例如:茶叶)
shopId
Number 店铺id 0
shopName
String 店铺名称
shopImage
String 店铺图片
shopUrl
String 店铺链接(点击可以跳转至店铺详情页)
startDate
String 开播日期(格式:2021-09-02)
mainItemId
Number 主商品ID
actorAvatar
String 主播头像
isEnd
Boolean 是否查询结束 false
nextId
Number 下次查询开始序号ID 0
resultCode
Number 响应码 1001
message
String 响应信息

请求参数示例

1).
{ "minId":0, "pageSize":100, "startDate":"2021-09-02" }

返回示例

1).
{ "extra": {}, "resultCode": 1001, "message": "success", "value": { "nextId": 100350, "data": [ { "actorDesc": "", "itemRootName": "服饰鞋包", "actorLevel": "", "liveTitle": "喵哥家韩系穿搭", "actorFansNum": 0, "shopName": "喵哥家", "actorName": "", "liveStartTime": "1630585215", "itemSecondName": "女装", "itemName": "喵哥家高腰系带碎花上衣", "itemSecondId": 683, "liveEndTime": "1630593877", "itemEndTime": "2021-09-02 22:44:37", "liveDuration": 8662, "actorOrderNum": 0, "actorPower": "", "id": 100350, "itemSoldNum": 1, "shopId": 128581, "liveHours": "", "liveImage": "https://s5.mogucdn.com/mlcdn/5abf39/180601_497k636aaeb148639k7bik4bbc754_400x400.jpg", "shopImage": "https://s5.mogucdn.com/http://s2.mogucdn.com/mlcdn/c45406/170408_39jaejhfii4302ill50l8j482k7e4_640x658.jpg", "actorReputation": 0, "liveSoldNum": 30, "shopUrl": "https://shop.mogu.com/15igy", "itemRootId": 682, "liveId": 12176828, "itemImage": "https://s5.mogucdn.com//mlcdn/c45406/210902_1d38764577194h7fgd0a1l5khl6b6_828x828.jpg", "liveItemNum": 15, "itemId": 696804612, "actorGender": "", "itemBrand": "", "actorId": 337141, "itemThirdName": "上装", "itemPrice": 0, "itemThirdId": 684, "actorLocation": "", "startDate": "2021-09-02", "itemStartTime": "2021-09-02 20:21:36", "liveGmv": 4401.99 } ], "currentPage": 1, "isEnd": false } }

异常示例

1).
{ "extra": {}, "resultCode": 1002, "message": "参数错误" }