# 获取带货者商品数据列表

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。

接口英文名：gettalentproductdata

获取合作管理列表中带货者商品数据列表

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/league/talent/getproductdatalist?access_token=ACCESS_TOKEN

# 云调用

本接口不支持云调用。

# 第三方调用

本接口支持第三方平台代微信小店商家调用。第三方服务商调用模式介绍
该接口所属的权限集 id 为：141
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代微信小店商家进行调用，具体可查看第三方调用说明文档。

# 2. 请求参数

# 查询参数 `Query String Parameters`

参数名	类型	必填	示例	说明
access_token	string	是	ACCESS_TOKEN	接口调用凭证，可使用 access_token（微信小店商家）、authorizer_access_token（服务商代调用）

# 请求体 `Request Payload`

参数名	类型	必填	示例	说明	枚举
get_data_type	number	是	1	获取的商品数据类型	枚举值
page_index	number	是	1	页面下标，下标从1开始，默认为1	-
page_size	number	是	10	单页带货者数（不超过20）	-
talent_appid	string	是	wxaaaaaa	带货者appid	-

# 3. 返回参数

# 返回体 `Response Payload`

参数名	类型	示例	说明
errcode	number	0	错误码
errmsg	string	ok	错误信息
total_num	number		商品总数
continue_flag	boolean		后面是否还有（true: 还有内容; false: 已结束）
list	objarray	-	商品信息列表

# Res.list(Array) `Object Payload`

商品信息列表

参数名	类型	说明
spu_id	number	商品id
product_data	object	商品数据
talent_commission_info	object	带货者佣金信息

# Res.list(Array).product_data `Object Payload`

商品数据

参数名	类型	说明
total_sale_gmv	number	销售额
sale_gmv_30d	number	30天销售额
total_order_num	number	成交订单数
order_num_30d	number	30天成交订单数

# Res.list(Array).talent_commission_info `Object Payload`

带货者佣金信息

参数名	类型	说明	枚举
commission_type	number	佣金类型	枚举值
ratio	number	佣金率[0, 1000000]，1000000 = 100%	-

# 4. 枚举信息

# Body.get_data_type `Enum`

获取的商品数据类型

枚举值	描述
1	近30天日成交商品数据
2	当前橱窗商品数据

# Res.list(Array).talent_commission_info.commission_type `Enum`

佣金类型

枚举值	描述
1	普通计划
2	定向计划
3	专属计划

# 5. 注意事项

本接口无特殊注意事项

# 6. 代码示例

请求示例

{
    "get_data_type": 1,
    "page_index": 1,
    "page_size": 10,
    "talent_appid": "wxaaaaaa"
}

返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "total_num": 0,
    "continue_flag": false,
    "list": [
        {
            "spu_id": 0,
            "product_data": {
                "total_sale_gmv": 0,
                "sale_gmv_30d": 0,
                "total_order_num": 0,
                "order_num_30d": 0
            },
            "talent_commission_info": {
                "commission_type": 0,
                "ratio": 0
            }
        }
    ]
}

# 7. 错误码

此接口没有特殊错误码，可参考通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具辅助定位和分析问题。

# 8. 适用范围

本接口支持「微信小店（需申请）」账号类型调用。其他账号类型如无特殊说明，均不可调用。

接口变更日志（1条）

2026 年 03 月 30 日

新增获取带货者商品数据列表