# 小程序商品查询接口

# 查询全量小程序商品

# 接口说明

支持开发者根据多种筛选条件获取可供推广的商品列表及详情,筛选条件包括商品关键词(名称、店铺、spuID)、商品累计销量、商品价格、商品佣金、佣金比例等

# 请求地址

GET https://api.weixin.qq.com/union/promoter/open_product/list?access_token=ACCESS_TOKEN

# 请求参数

属性 类型 默认值 必填 说明
access_token string 接口调用凭证
from string 偏移,从0开始
limit string 每页条数,最大为30个
query string 搜索关键词,具体含义与queryType相关
queryType number 0 搜索类型
maxPrice number 商品最高价格,单位分
minPrice number 0 商品最低价格,单位分
minCommissionValue number 0 佣金金额下限,单位分
minCommissionRatio number 0 佣金比例下限,单位万分之一
sortType number 0
categoryId number 单个类目ID,值来自获取类目列表接口
shopAppIds Array.<string> 小程序AppID列表
category string 多个类目ID,多个用英文逗号分隔。若与categoryid同时存在,取categoryid
noCategory string 黑名单类目ID,不拉出黑名单类目商品,多个用英文逗号分隔
productId string 商品SPUID,多个用英文逗号分隔

queryType 的枚举

类型 说明
0 number 搜索商品名称
1 number 搜索小程序名称
2 number 搜索商品组件SPUID

sortType 的枚举

类型 说明
0 number 默认排序
1 number 商品价格升序
2 number 商品价格降序
3 number 佣金比例升序
4 number 佣金比例降序
5 number 佣金数值升序
6 number 佣金数值降序

# 返回值

属性 类型 说明
errcode number 错误码
errmsg string 错误信息
total number 商品总数
productList Array.<Object> 商品列表数据
leagueExInfo Object 联盟佣金相关数据

productList 的结构

属性 类型 说明
product Object 商品数据
shopInfo Object 商品所属小程序数据

product 的结构

属性 类型 说明
productId string 商品组件SPUID
info Object 商品具体信息
info.title string 商品标题
info.headImg Array.<string> 商品主图
info.category Array.<string> 商品类目
info.category[].catId Object 类目ID
info.category[].name Object 类目名称
info.brandId string 品牌ID
info.detail Object 商品详细数据
info.detail.detailImg Array.<string> 商品详情图片
info.minPrice number 商品最低价格,单位分
info.totalStockNum number 总库存
info.path string 商品详情页path
skus Array.<Object> 商品SKU
skus[].skuId string 商品组件SKUID
skus[].productSkuInfo.thumbImg string 商品SKU 小图
skus[].productSkuInfo.salePrice Object 商品SKU 销售价格,单位分
skus[].productSkuInfo.marketPrice Object 商品SKU 市场价格,单位分
skus[].productSkuInfo.stockInfo.stockNum number 商品SKU 库存

leagueExInfo 的结构

属性 类型 说明
hasCommission number 是否有佣金,1/0
commissionRatio number 佣金比例,万分之一
commissionValue number 佣金金额,单位分

shopInfo 的结构

属性 类型 说明
name number 小程序名称
appId string 小程序AppID
username string 小程序原始id
headImgUrl string 小程序头像

# 返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "total": 59,
    "productList": [
        {
            "shopInfo": {
                "name": "医保非税小测试",
                "appId": "wx539e0b4872f196d1",
                "username": "gh_6e10896a3e3c",
                "headImgUrl": "http://wx.qlogo.cn/mmhead/Q3auHgzwzM6PxkhYKuFL3Xy6ibu3lJAhosuicqM92GLDdBRHySZuVibiag"
            },
            "product": {
                "productId": "411668902",
                "info": {
                    "title": "金幼小儿米茶膏11.8g*抑菌霜(限时送好产品)(1625192914000)",
                    "headImg": [
                        "https://snsdy.tc.qq.com/161/20304/snscosdownload/SZ/reserved/5fc36818000f255f00000000d0785609000000a000004f50?imageView2/3/w/750"
                    ],
                    "brandId": "2100000000",
                    "detail": {},
                    "minPrice": 1,
                    "totalStockNum": 100,
                    "path": "pages/productDetail/productDetail?productId=1625192914000"
                },
                "skus": [
                    {
                        "skuId": "350377364",
                        "productSkuInfo": {
                            "thumbImg": "https://store.mp.video.tencent-cloud.com/161/20304/snscosdownload/SH/reserved/60de79d30007ec2000000000c7e04f09000000a100004f50",
                            "salePrice": 1,
                            "marketPrice": 1,
                            "stockNum": "100"
                        }
                    }
                ]
            }
        }
    ]
}