获取可推广的商品id列表

# 获取可推广的商品id列表

# 接口说明

可通过该接口，可获取可推广的商品id列表

# 接口调用请求说明

POST https://api.weixin.qq.com/channels/ec/promoter/get_bind_sharer_list?access_token=ACCESS_TOKEN

# 请求参数说明

参数	类型	是否必填	描述
plan_type	number	是	商品的计划类型 1：定向计划 2：公开计划
spu_item_condition	object SpuItemCondition	否	商品查询条件，结构体详情请参考SpuItemCondition结构体
category	object Category	否	商品类目查询条件，定向计划不支持。结构体详情请参考Category结构体
keyword	string	否	搜索关键词
next_key	string	是	分页参数，第一页为空，后面返回前面一页返回的数据
page_size	number	是	一页获取多少个商品，最大 20

# 结构体

# SpuItemCondition

商品查询条件

参数	类型	描述
selling_price_range	object Range	售卖价区间，单位是分。结构体详情请参考Range结构体
monthly_sales_range	object Range	月销量区间，结构体详情请参考Range结构体
flags	string array	保障标，0-7天无理由；1-运费险；2-品牌（已废弃）；3-放心买；4-损坏包退；5-假一赔三；6-先用后付；7-包邮；
service_fee_rate_range	object Range	服务费率区间，单位是10万分之。结构体详情请参考Range结构体
commission_rate_range	object Range	佣金率区间，单位是10万分之。结构体详情请参考Range结构体
promote_time_range	object Range	推广时间范围，结构体详情请参考Range结构体

# Range

范围

参数	类型	描述
min	string	区间最小值
max	string	区间最大值

# Category

商品类目查询条件

目前大部分情况只有一级类目，请求时填一级即可。

参数	类型	描述
category_id	string	商品类目
category_name	string	商品类目名称，可填空
category_ids_1	string array	一级类目列表
category_ids_2	string array	二级类目列表
category_ids_3	string array	三级类目列表

商品类目查询参考

请求时只需将列数组中的一个元素填入category即可。

{
    "categorys": [
        {
            "category_id": 11099070301657575487,
            "category_ids_1": [7339,502043,7419,6625],
            "category_name": "食品生鲜"
        },
        {
            "category_id": 16579416177373560313,
            "category_ids_1": [6033,1653,6831,7378,6932],
            "category_name": "服饰鞋包"
        },
        {
            "category_id": 17007902228422672609,
            "category_ids_1": [1001,6870],
            "category_name": "个护美妆"
        },
        {
            "category_id": 12377324634086192020,
            "category_ids_1": [135835],
            "category_name": "图书"
        },
        {
            "category_id": 8261345894708739273,
            "category_ids_1": [1142,1421,1453,1208,6153,6472,1069,1247],
            "category_name": "家清日用"
        },
        {
            "category_id": 12379480883574690382,
            "category_ids_1": [530004,376707,1804,442005,1701,381003,128209,6263,377078,378228,530032,7363,378136,429008,6706],
            "category_name": "其他"
        }
    ]
}

# 请求参数示例

// 原请求同样适用，不填则默认不设置任何条件查询所有商品列表
{
    "next_key": "",
    "page_size": 10,
    "plan_type":1
}

// 搜索示例
{
    "next_key": "",
    "page_size": 10,
    "plan_type":1,
    "category": {
        "category_id": "8261345894708739273",
        "category_ids_1": ["1142","1421","1453","1208","6153","6472","1069","1247"],
        "category_name": "家清日用"
    },
    "keyword": "纸巾",
    "spu_item_condition": {
        "commission_rate_range": {
            "max": "100000",
            "min": "0"
        }
    }
}

# 返回参数说明

参数	类型	描述
errcode	number	错误码
errmsg	string	错误信息
next_key	string	分页参数
product_list	array object ProductInfo	商品列表

# 结构体

# ProductInfo

绑定的推客内容

参数	类型	描述
product_id	number	商品 id
shop_appid	string	商品所属店铺 appid

# 返回参数示例

{
  "errcode": "0",
  "errmsg": "ok",
  "product_list":[
    {
        "product_id": 1,
        "shop_appid": "SHOPAPPID"
    }
  ],
  "next_key": "PAGECONTEXT"
}

# 错误码

错误码	错误描述
公共错误码	-
10024000	参数错误