##  一、开发指南

首先，机构需登录[联盟带货机构管理平台](https://channels.weixin.qq.com/ec-mcn/auth/login)  打开【推客带货】-点击内容合作，邀请达人带货者/小店完成内容合作设置，再调用相关API接口配置“内容”到带货小程序

**达人内容合作**：选择“下载二维码”并发送给达人      **小店内容合作**：选择“复制链接”发送给微信小店管理员
![](https://res8.wxqcloud.qq.com.cn/wxdoc/5dec0cf0-b802-4d13-805c-fc8494d147d0.png)

具体详细操作请查看： [微信小店优选联盟带货机构「推客带货功能」使用指南](https://store.weixin.qq.com/chengzhang/webdoc/wiki/7129/eaecf8415ca86666/growth_center_manual_for_promoter) 

### 推客机构获取直播内容推广API调用流程:
![](https://res8.wxqcloud.qq.com.cn/wxdoc/f8503a0a-5997-4c4f-8b92-4130afa6978f.png)

### 推客机构获取短视频内容推广API调用流程:
![](https://res8.wxqcloud.qq.com.cn/wxdoc/9b318302-b663-41e4-9dbb-21d75057aac7.png)

## 二、核心功能及接口
### 直播推广
**带货者**

- 调用[获取合作的带货者列表](/doc/store/leagueheadsupplier/api/sharer/account/api_getbindtalentlist)接口获取talent_list，记录talent_appid（带货者的id）在下一步使用

- 调用[获取带货者的直播列表](/doc/store/leagueheadsupplier/api/sharer/live/api_getliverecordlist)接口传入talent_appid和mini_program_appid（获得方式：联盟带货机构管理平台—设置—开放信息—关联小程序）获取当前直播的直播数据，记录export_id在下一步使用

- 调用[为某个推客生成单个直播的推广二维码](/doc/store/leagueheadsupplier/api/sharer/live/api_getliverecordqrcode)接口传入talent_appid、export_id、sharer_appid（获得方式：[获取机构绑定的推客信息](/doc/store/leagueheadsupplier/api/sharer/account/api_getbindsharerlist)或[推客绑定机构的回调](/doc/store/leagueheadsupplier/callback/promoter_bind_event)），为推客生成二维码的 url

**小店关联账号**

- 调用[获取合作的小店列表](/doc/store/leagueheadsupplier/api/sharer/account/api_getbindshoplist)接口获取shop_list，记录shop_appid（小店的 appid）在下一步使用

- 调用[获取合作小店的关联账号列表](/doc/store/leagueheadsupplier/api/sharer/account/api_getbindshoppromoterlist)接口传入shop_appid获取合作小店的关联账号列表，记录下promoter_id（关联账号的id）和promoter_type（1：视频号；4：公众号；5：服务号）在下一步使用

- 调用[获取小店关联账号的直播列表](/doc/store/leagueheadsupplier/api/sharer/live/api_getshopliverecordlist)接口传入shop_appid、promoter_id、mini_program_appid（获取方式：登陆联盟管理平台——设置——开放信息中可查看）、sharer_appid（获取方式：[获取机构绑定的推客信息](/doc/store/leagueheadsupplier/api/sharer/account/api_getbindsharerlist)或[推客绑定机构的回调](/doc/store/leagueheadsupplier/callback/promoter_bind_event)）、promoter_type获取当前直播数据，记录export_id在下一步使用

- 调用[为推客生成小店关联账号直播的推广二维码](/doc/store/leagueheadsupplier/api/sharer/live/api_getshopliverecordqrcode)接口传入shop_appid、promoter_id、export_id、sharer_appid、promoter_type，为推客生成二维码的 url

### 获取直播推广统计数据

- 调用[获取直播推广统计数据](/doc/store/leagueheadsupplier/api/sharer/live/api_getpromoterlivestats)接口，机构可通过该接口获取推客推广直播的转发和用户观看统计数据（注：2025年10月25功能上线，这个时间点之后的数据才有效）

### 获取小店关联账号的当前直播的自营商品列表

- 调用[获取小店关联账号的当前直播的自营商品列表](/doc/store/leagueheadsupplier/api/sharer/live/api_getshoplivecommissionproductlist)接口，机构可获取小店关联账号的当前直播的自营商品列表

## 预约直播推广
**带货者**

- 调用[获取合作的带货者列表](/doc/store/leagueheadsupplier/api/sharer/account/api_getbindtalentlist)接口获取talent_list，记录talent_appid（带货者的id）在下一步使用

- 调用[获取带货者的直播预约列表](/doc/store/leagueheadsupplier/api/sharer/live/api_getlivenoticerecordlist)接口传入talent_appid获取直播预约数据，记录notice_id在下一步使用

- 调用[为某个推客生成单个直播预约的推广二维码](/doc/store/leagueheadsupplier/api/sharer/live/api_getlivenoticerecordqrcode)接口传入talent_appid、notice_id、sharer_appid（获取方式：[获取机构绑定的推客信息](/doc/store/leagueheadsupplier/api/sharer/account/api_getbindsharerlist)或[推客绑定机构的回调](/doc/store/leagueheadsupplier/callback/promoter_bind_event)），为推客生成预约二维码的 url

**小店关联账号**

- 调用[获取合作的小店列表](/doc/store/leagueheadsupplier/api/sharer/account/api_getbindshoplist)接口获取shop_list，记录shop_appid（小店的 appid）在下一步使用

- 调用[获取合作小店的关联账号列表](/doc/store/leagueheadsupplier/api/sharer/account/api_getbindshoppromoterlist)接口传入shop_appid获取合作小店的关联账号列表，记录下promoter_id（关联账号的id）和promoter_type（1：视频号；4：公众号；5：服务号）在下一步使用

- 调用[获取合作小店的关联账号列表](/doc/store/leagueheadsupplier/api/sharer/account/api_getbindshoppromoterlist)接口传入shop_appid、promoter_id、promoter_type获取直播预约数据，记录notice_id在下一步使用

- 调用[获取小店关联账号的预约直播列表](/doc/store/leagueheadsupplier/api/sharer/live/api_getshoplivenoticerecordlist)接口传入shop_appid、promoter_id、notice_id、sharer_appid、promoter_type，为推客生成预约二维码的 url
获取直播预告推广统计数据

- 调用[获取直播预告推广统计数据](/doc/store/leagueheadsupplier/api/sharer/live/api_getlivenoticestats)接口，机构可获取推客推广直播预告的用户预约和用户观看统计数据（注：2025年10月25功能上线，这个时间点之后的数据才有效）
### 生成某个带货者的用于直播预约的推广参数

- 调用[生成某个带货者的用于直播预约的推广参数](/doc/store/leagueheadsupplier/api/sharer/live/api_getlivenoticepromotersharelink)接口，机构可生成某个带货者的用于直播预约的推广参数
###  为推客获取小店关联账号直播预约的推广参数

- 调用[为推客获取小店关联账号直播预约的推广参数](/doc/store/leagueheadsupplier/api/sharer/live/api_getshoplivenoticepromotersharelink)接口，机构可为推客获取小店关联账号直播预约的推广参数

## 短视频推广
**带货者**

- 调用[获取合作的带货者列表](/doc/store/leagueheadsupplier/api/sharer/account/api_getbindtalentlist)接口获取talent_list，记录talent_appid（带货者的id）在下一步使用

- 调用[获取带货者推广的短视频信息](/doc/store/leagueheadsupplier/api/sharer/video/api_getfeedlist)接口传入talent_appid获取可推广的短视频信息，记录下feed_list在下一步使用

- 调用[生成某个带货者的某些短视频内嵌短视频卡片需要的feedtoken](/doc/store/leagueheadsupplier/api/sharer/video/api_getfeedpromotioninfo)接口传入feed_list、mini_program_appid、talent_appid、sharer_appid，可生成某个带货者的某些短视频内嵌短视频卡片需要的feedtoken

**小店关联账号**

- 调用[获取合作的小店列表](/doc/store/leagueheadsupplier/api/sharer/account/api_getbindshoplist)接口获取shop_list，记录shop_appid（小店的 appid）在下一步使用

- 调用[获取合作小店的关联账号列表](/doc/store/leagueheadsupplier/api/sharer/account/api_getbindshoppromoterlist)接口传入shop_appid获取合作小店的关联账号列表，记录下promoter_id（关联账号的id）和promoter_type（1：视频号；4：公众号；5：服务号）在下一步使用

- 调用[获取小店关联账号的短视频列表](/doc/store/leagueheadsupplier/api/sharer/video/api_getshopfeedlist)接口传入shop_appid、promoter_id、promoter_type获取可推广的短视频列表，记录下feed_list在下一步使用

- 调用[生成小店关联账号的短视频内嵌小程序推广信息](/doc/store/leagueheadsupplier/api/sharer/video/api_getshopfeedpromotioninfo)接口传入shop_appid、promoter_id、promoter_type、mini_program_appid、feed_list，可生成小店关联账号的短视频内嵌短视频卡片需要的feedtoke
## 其他
### 获取直播大场保护的提报二维码
- 调用[获取直播大场保护的提报二维码](/doc/store/leagueheadsupplier/api/sharer/live/api_getliveprotectionqrcode)接口，机构可为符合条件的机构生成直播大场保护提报二维码，机构可将该二维码分发给指定达人扫码完成报备

![](https://res8.wxqcloud.qq.com.cn/wxdoc/56617deb-b17d-4cf1-bccd-71d2c41ccc76.svg)文档变更日志（1条）
2025 年 11 月 13 日新增推客获取合作内容开发指南
