视频号
取消
中文
中文
EN
取消
  • 介绍

    • # 获取带货达人列表

    # 接口说明

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

    # 接口调用请求说明

    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 请求参数日期格式有误