拼多多商品查询参数
基于拼多多开放平台API文档
拼多多开放平台 API 文档:pdd.ddk.oauth.goods.search
参数名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
keyword | string | 非必填 | 商品关键词,与 opt_id 字段选填一个或全部填写。可支持 goods_id、拼多多链接(即拼多多 app 商详的链接)、进宝长链/短链(即为 pdd.ddk.goods.promotion.url.generate 接口生成的长短链) |
activity_tags | array | 非必填 | 活动商品标记数组,例:[4,7],4-秒杀,7-百亿补贴,10851-千万补贴,11879-千万神券,10913-招商礼金商品,31-品牌黑标,10564-精选爆品-官方直推爆款,10584-精选爆品-团长推荐,24-品牌高佣,其他的值请忽略 |
block_cat_packages | array | 非必填 | 屏蔽商品类目包:1-拼多多小程序屏蔽的类目&关键词;2-虚拟类目;3-医疗器械;4-处方药;5-非处方药 |
block_cats | array | 非必填 | 自定义屏蔽一级/二级/三级类目 ID,自定义数量不超过 20 个;使用 pdd.goods.cats.get 接口获取 cat_id |
cat_id | number | 非必填 | 商品类目 ID,使用 pdd.goods.cats.get 接口获取 |
custom_parameters | string | 非必填 | 自定义参数,为链接打上自定义标签;自定义参数最长限制 64 个字节;格式为: {"uid":"11111","sid":"22222"} ,其中 uid 用户唯一标识,可自行加密后传入,每个用户仅且对应一个标识,必填; sid 上下文信息标识,例如 sessionId 等,非必填。该 json 字符串中也可以加入其他自定义的 key。(如果使用 GET 请求,请使用 URLEncode 处理参数) |
force_auth_duo_id | boolean | 非必填 | 是否使用工具商专属推广计划,默认为 false |
goods_img_type | number | 非必填 | 商品主图类型:1-场景图,2-白底图,默认为 0 |
goods_sign_list | array | 非必填 | 商品 goodsSign 列表,例如:["c9r2omogKFFAc7WBwvbZU1ikIb16_J3CTa8HNN"] ,支持通过 goodsSign 查询商品。goodsSign 是加密后的 goodsId, goodsId 已下线,请使用 goodsSign 来替代。使用说明:https://jinbao.pinduoduo.com/qa-system?questionId=252 |
is_brand_goods | boolean | 非必填 | 是否为品牌商品 |
list_id | string | 非必填 | 翻页时建议填写前页返回的 list_id 值 |
merchant_type | number | 非必填 | 店铺类型,1-个人,2-企业,3-旗舰店,4-专卖店,5-专营店,6-普通店(未传为全部) |
merchant_type_list | array | 非必填 | 店铺类型数组,例如:[1,2] |
opt_id | number | 非必填 | 商品标签类目 ID,与 keyword 字段选填一个或全部填写,使用 pdd.goods.opt.get 获取 |
page | number | 非必填 | 默认值 1,商品分页数 |
page_size | number | 非必填 | 默认 100,每页商品数量 |
range_list | array | 非必填 | 筛选范围列表 样例:[{"range_id":0,"range_from":1,"range_to":1500},{"range_id":1,"range_from":1,"range_to":1500}] |
risk_params | object | 非必填 | 风控参数 |
sort_type | number | 非必填 | 排序方式:0-综合排序;1-按佣金比率升序;2-按佣金比例降序;3-按价格升序;4-按价格降序;5-按销量升序;6-按销量降序;7-优惠券金额排序升序;8-优惠券金额排序降序;9-券后价升序排序;10-券后价降序排序;11-按照加入多多进宝时间升序;12-按照加入多多进宝时间降序;13-按佣金金额升序排序;14-按佣金金额降序排序;15-店铺描述评分升序;16-店铺描述评分降序;17-店铺物流评分升序;18-店铺物流评分降序;19-店铺服务评分升序;20-店铺服务评分降序;27-描述评分击败同类店铺百分比升序,28-描述评分击败同类店铺百分比降序,29-物流评分击败同类店铺百分比升序,30-物流评分击败同类店铺百分比降序,31-服务评分击败同类店铺百分比升序,32-服务评分击败同类店铺百分比降序 |
use_customized | boolean | 非必填 | 是否使用个性化推荐,true 表示使用,false 表示不使用,默认 true。 |
with_coupon | boolean | 非必填 | 是否只返回优惠券的商品,false 返回所有商品,true 只返回有优惠券的商品 |