xiaodian.data.queryItemData

  • 免费
  • 无需授权

API功能描述(支持get和post)

查询商品的T+1数据

公共参数

名称 类型 必选 描述
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

输入参数

名称 类型 必选 描述 示例值
itemDataQuery Object 商品数据查询参数
itemId Number 商品id
startDate String 开始时间,格式为yyyy-MM-dd
endDate String 结束时间,格式为yyyy-MM-dd
pageSize Number 分页的尺寸,每次最大为10
pageNum String 当前页

返回参数

名称 类型 描述 默认值
result Object 返回结果
data Object 返回结果实体
list Object 数据列表
pageNum Number 页码
total Number 总数
isEnd Boolean true-是尾页 

请求参数示例

1).
{"itemDataQuery":{"startDate":"2020-08-14","endDate":"2020-08-20","pageSize":10,"pageNum":1}}

返回示例

1).
{ "status": { "code": "0000000", "msg": "调用成功" }, "result": { "data": { "total": 3, "list": [ { "itemId": "1qkx0ow", "uv": 0, "pay_item_num": 2, "skuList": [ { "addcart_num": 0, "pay_order_num": 2, "sku_info": "7天", "sku_price": 0.01, "pay_user_num": 1, "addcart_user_cnt": 0, "pay_gmv": 0.02, "pay_rate": "100.00%", "skuId": "119k5j34", "create_order_num": 3 } ], "pay_order_num": 2, "pv": 0, "price": 0.01, "pay_user_num": 1, "pay_gmv": "0.02", "pay_rate": "0%" }, { "itemId": "1qmkrpk", "uv": 0, "pay_item_num": 0, "skuList": [ { "addcart_num": 0, "pay_order_num": 0, "sku_info": "", "sku_price": 1, "pay_user_num": 0, "addcart_user_cnt": 0, "pay_gmv": 0, "pay_rate": "0.00%", "skuId": "119kjl5q", "create_order_num": 0 } ], "pay_order_num": 0, "pv": 0, "price": 1, "pay_user_num": 0, "pay_gmv": "0", "pay_rate": "0%" }, { "itemId": "1qmg4nq", "uv": 0, "pay_item_num": 0, "skuList": [ { "addcart_num": 0, "pay_order_num": 0, "sku_info": "", "sku_price": 1, "pay_user_num": 0, "addcart_user_cnt": 0, "pay_gmv": 0, "pay_rate": "0.00%", "skuId": "119jwvim", "create_order_num": 1 } ], "pay_order_num": 0, "pv": 0, "price": 1, "pay_user_num": 0, "pay_gmv": "0", "pay_rate": "0%" } ], "pageNum": 1, "isEnd": true } }, "success": true }

异常示例

常见问题

1).返回值字段的定义
itemId-商品id uv-访问人数 pv-访问次数 pay_user_num-成交人数 pay_item_num-成交商品件数 price-商品价格 pay_gmv-成交金额 pay_order_num-成交订单数 pay_rate-成交转化率 skuId-sku的id sku_info-sku信息 sku_price-sku价格 addcart_num-加购件数 addcart_user_cnt-加购人数 create_order_num-生成订单数