# 一、开发指南

首先，机构需登录联盟带货机构管理平台 打开【推客带货】-点击内容合作，邀请达人带货者/小店完成内容合作设置，再调用相关API接口配置“内容”到带货小程序

达人内容合作：选择“下载二维码”并发送给达人 小店内容合作：选择“复制链接”发送给微信小店管理员

具体详细操作请查看： 微信小店优选联盟带货机构「推客带货功能」使用指南

# 推客机构获取直播内容推广API调用流程:

# 推客机构获取短视频内容推广API调用流程:

# 二、核心功能及接口

# 直播推广

带货者

• 调用[获取合作的带货者列表](获取合作的带货者列表接口获取talent_list，记录talent_appid（带货者的id）在下一步使用

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

• 调用为某个推客生成单个直播的推广二维码接口传入talent_appid、export_id、sharer_appid（获得方式：获取机构绑定的推客信息或推客绑定机构的回调），为推客生成二维码的 url

小店关联账号

• 调用获取合作的小店列表接口获取shop_list，记录shop_appid（小店的 appid）在下一步使用

• 调用获取合作小店的关联账号列表接口传入shop_appid获取合作小店的关联账号列表，记录下promoter_id（关联账号的id）和promoter_type（1：视频号；4：公众号；5：服务号）在下一步使用

• 调用获取小店关联账号的直播列表接口传入shop_appid、promoter_id、mini_program_appid（获取方式：登陆联盟管理平台——设置——开放信息中可查看）、sharer_appid（获取方式：获取机构绑定的推客信息或推客绑定机构的回调）、promoter_type获取当前直播数据，记录export_id在下一步使用

• 调用为推客生成小店关联账号直播的推广二维码接口传入shop_appid、promoter_id、export_id、sharer_appid、promoter_type，为推客生成二维码的 url

# 获取直播推广统计数据

• 调用获取直播推广统计数据接口，机构可通过该接口获取推客推广直播的转发和用户观看统计数据（注：2025年10月25功能上线，这个时间点之后的数据才有效）

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

• 调用获取小店关联账号的当前直播的自营商品列表接口，机构可获取小店关联账号的当前直播的自营商品列表

# 预约直播推广

带货者

• 调用获取合作的带货者列表接口获取talent_list，记录talent_appid（带货者的id）在下一步使用

• 调用获取带货者的直播预约列表接口传入talent_appid获取直播预约数据，记录notice_id在下一步使用

• 调用为某个推客生成单个直播预约的推广二维码接口传入talent_appid、notice_id、sharer_appid（获取方式：获取机构绑定的推客信息或推客绑定机构的回调），为推客生成预约二维码的 url

小店关联账号

• 调用获取合作的小店列表接口获取shop_list，记录shop_appid（小店的 appid）在下一步使用

• 调用获取合作小店的关联账号列表接口传入shop_appid获取合作小店的关联账号列表，记录下promoter_id（关联账号的id）和promoter_type（1：视频号；4：公众号；5：服务号）在下一步使用

• 调用获取合作小店的关联账号列表接口传入shop_appid、promoter_id、promoter_type获取直播预约数据，记录notice_id在下一步使用

• 调用获取小店关联账号的预约直播列表接口传入shop_appid、promoter_id、notice_id、sharer_appid、promoter_type，为推客生成预约二维码的 url 获取直播预告推广统计数据

• 调用获取直播预告推广统计数据接口，机构可获取推客推广直播预告的用户预约和用户观看统计数据（注：2025年10月25功能上线，这个时间点之后的数据才有效）

# 生成某个带货者的用于直播预约的推广参数

• 调用生成某个带货者的用于直播预约的推广参数接口，机构可生成某个带货者的用于直播预约的推广参数

# 为推客获取小店关联账号直播预约的推广参数

• 调用为推客获取小店关联账号直播预约的推广参数接口，机构可为推客获取小店关联账号直播预约的推广参数

# 短视频推广

带货者

• 调用获取合作的带货者列表接口获取talent_list，记录talent_appid（带货者的id）在下一步使用

• 调用获取带货者推广的短视频信息接口传入talent_appid获取可推广的短视频信息，记录下feed_list在下一步使用

• 调用生成某个带货者的某些短视频内嵌短视频卡片需要的feedtoken接口传入feed_list、mini_program_appid、talent_appid、sharer_appid，可生成某个带货者的某些短视频内嵌短视频卡片需要的feedtoken

小店关联账号

• 调用获取合作的小店列表接口获取shop_list，记录shop_appid（小店的 appid）在下一步使用

• 调用获取合作小店的关联账号列表接口传入shop_appid获取合作小店的关联账号列表，记录下promoter_id（关联账号的id）和promoter_type（1：视频号；4：公众号；5：服务号）在下一步使用

• 调用获取小店关联账号的短视频列表接口传入shop_appid、promoter_id、promoter_type获取可推广的短视频列表，记录下feed_list在下一步使用

• 调用生成小店关联账号的短视频内嵌小程序推广信息接口传入shop_appid、promoter_id、promoter_type、mini_program_appid、feed_list，可生成小店关联账号的短视频内嵌短视频卡片需要的feedtoke

# 其他

# 获取直播大场保护的提报二维码

• 调用获取直播大场保护的提报二维码接口，机构可为符合条件的机构生成直播大场保护提报二维码，机构可将该二维码分发给指定达人扫码完成报备