获取带货达人列表 | 微信开放文档

# 获取带货达人列表

# 接口说明

通过该接口可获取带货达人列表数据。（仅返回当日有带货数据的达人）

# 接口调用请求说明

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

# 请求参数说明

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

# 请求参数示例

{
    "ds": "20240520"
}

# 返回参数说明

参数	类型	描述
errcode	number	错误码
errmsg	string	错误信息
finder_list[].finder_id	string	视频号id
finder_list[].finder_nickname	string[]	视频号昵称
finder_list[].data.pay_gmv	string	成交金额，单位分
finder_list[].data.pay_product_id_cnt	string	动销商品数
finder_list[].data.pay_uv	string	成交人数
finder_list[].data.refund_gmv	string	退款金额，单位分
finder_list[].data.pay_refund_gmv	string	成交退款金额，单位分

# 返回参数示例

{
  "errcode": 0,
  "errmsg": "ok",
  "finder_list": [
    {
      "finder_id": "sphIEqMmbCyGrjd",
      "finder_nickname": "momqw123456",
      "data": {
        "pay_gmv": "1",
        "pay_product_id_cnt": "1",
        "pay_uv": "1",
        "refund_gmv": "0",
        "pay_refund_gmv": "0"
      }
    },
    {
      "finder_id": "sphAZh85q8DcOEx",
      "finder_nickname": "小猫想养狸花小猫",
      "data": {
        "pay_gmv": "0",
        "pay_product_id_cnt": "0",
        "pay_uv": "0",
        "refund_gmv": "0",
        "pay_refund_gmv": "0"
      }
    },
    {
      "finder_id": "spho6H66NXuU3wT",
      "finder_nickname": "人间贩卖打工人",
      "data": {
        "pay_gmv": "0",
        "pay_product_id_cnt": "0",
        "pay_uv": "0",
        "refund_gmv": "0",
        "pay_refund_gmv": "0"
      }
    }
  ]
}

# 错误码

错误码	错误描述
公共错误码	-
10021069	请求参数日期格式有误