API 列表

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": "参数错误"
}

API测试工具