# 获取带货商品列表

# 接口说明

通过该接口可获取带货商品列表。

# 接口调用请求说明

POST https://api.weixin.qq.com/channels/ec/compass/finder/product/list/get?access_token=ACCESS_TOKEN

# 请求参数说明

参数 类型 是否必填 描述
ds string 日期,格式YYYYMMDD

# 请求参数示例

{
    "ds": "20240520"
}

# 返回参数说明

参数 类型 描述
errcode number 错误码
errmsg string 错误信息
product_list[].product_id string 商品id
product_list[].head_img_url string 商品头图
product_list[].title string 商品标题
product_list[].price string 商品价格
product_list[].first_category_id string 1级类目
product_list[].second_category_id string 2级类目
product_list[].third_category_id string 3级类目
product_list[].data.pay_gmv string 成交金额
product_list[].data.create_gmv string 下单金额(单位:分)
product_list[].data.create_cnt string 下单订单数
product_list[].data.create_uv string 下单人数
product_list[].data.create_product_cnt string 下单件数
product_list[].data.pay_cnt string 成交订单数
product_list[].data.pay_uv string 成交人数
product_list[].data.pay_product_cnt string 成交件数
product_list[].data.pure_pay_gmv string 成交金额(剔除退款)(单位:分)
product_list[].data.pay_gmv_per_uv number 成交客单价(单位:分)
product_list[].data.actual_commission string 实际结算金额(单位:分)
product_list[].data.predict_commission string 预估佣金金额(单位:分)
product_list[].data.product_click_uv string 商品点击人数
product_list[].data.product_click_cnt string 商品点击次数
product_list[].data.pay_refund_gmv string 成交退款金额
product_list[].data.pay_refund_uv string 成交退款人数
product_list[].data.pay_refund_ratio float 成交退款率
product_list[].data.pay_refund_after_send_ratio float 发货后成交退款率
product_list[].data.pay_refund_cnt string 成交退款订单数
product_list[].data.pay_refund_product_cnt string 成交退款件数
product_list[].data.pay_refund_before_send_ratio float 发货前成交退款率
product_list[].data.refund_gmv string 退款金额(单位:分)
product_list[].data.refund_product_cnt string 退款件数
product_list[].data.refund_cnt string 退款订单数
product_list[].data.refund_uv string 退款人数

# 返回参数示例

{
  "errcode": 0,
  "errmsg": "ok"
}

# 错误码

错误码 错误描述
公共错误码 -
48001 接口权限未开启,需前往视频号助手- 开放能力-开放场景 打开开关
10021069 请求参数日期格式有误