小程序商品查询接口 | 微信开放文档

# 小程序商品查询接口

# 查询全量小程序商品

# 接口说明

支持开发者根据多种筛选条件获取可供推广的商品列表及详情，筛选条件包括商品关键词（名称、店铺、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"
                        }
                    }
                ]
            }
        }
    ]
}