tao-mcp

拼多多商品查询参数

基于拼多多开放平台API文档

拼多多开放平台 API 文档:pdd.ddk.oauth.goods.search

参数名类型是否必填描述
keywordstring非必填商品关键词,与 opt_id 字段选填一个或全部填写。可支持 goods_id、拼多多链接(即拼多多 app 商详的链接)、进宝长链/短链(即为 pdd.ddk.goods.promotion.url.generate 接口生成的长短链)
activity_tagsarray非必填活动商品标记数组,例:[4,7],4-秒杀,7-百亿补贴,10851-千万补贴,11879-千万神券,10913-招商礼金商品,31-品牌黑标,10564-精选爆品-官方直推爆款,10584-精选爆品-团长推荐,24-品牌高佣,其他的值请忽略
block_cat_packagesarray非必填屏蔽商品类目包:1-拼多多小程序屏蔽的类目&关键词;2-虚拟类目;3-医疗器械;4-处方药;5-非处方药
block_catsarray非必填自定义屏蔽一级/二级/三级类目 ID,自定义数量不超过 20 个;使用 pdd.goods.cats.get 接口获取 cat_id
cat_idnumber非必填商品类目 ID,使用 pdd.goods.cats.get 接口获取
custom_parametersstring非必填自定义参数,为链接打上自定义标签;自定义参数最长限制 64 个字节;格式为: {"uid":"11111","sid":"22222"} ,其中 uid 用户唯一标识,可自行加密后传入,每个用户仅且对应一个标识,必填; sid 上下文信息标识,例如 sessionId 等,非必填。该 json 字符串中也可以加入其他自定义的 key。(如果使用 GET 请求,请使用 URLEncode 处理参数)
force_auth_duo_idboolean非必填是否使用工具商专属推广计划,默认为 false
goods_img_typenumber非必填商品主图类型:1-场景图,2-白底图,默认为 0
goods_sign_listarray非必填商品 goodsSign 列表,例如:["c9r2omogKFFAc7WBwvbZU1ikIb16_J3CTa8HNN"],支持通过 goodsSign 查询商品。goodsSign 是加密后的 goodsId, goodsId 已下线,请使用 goodsSign 来替代。使用说明:https://jinbao.pinduoduo.com/qa-system?questionId=252
is_brand_goodsboolean非必填是否为品牌商品
list_idstring非必填翻页时建议填写前页返回的 list_id 值
merchant_typenumber非必填店铺类型,1-个人,2-企业,3-旗舰店,4-专卖店,5-专营店,6-普通店(未传为全部)
merchant_type_listarray非必填店铺类型数组,例如:[1,2]
opt_idnumber非必填商品标签类目 ID,与 keyword 字段选填一个或全部填写,使用 pdd.goods.opt.get 获取
pagenumber非必填默认值 1,商品分页数
page_sizenumber非必填默认 100,每页商品数量
range_listarray非必填筛选范围列表 样例:[{"range_id":0,"range_from":1,"range_to":1500},{"range_id":1,"range_from":1,"range_to":1500}]
risk_paramsobject非必填风控参数
sort_typenumber非必填排序方式: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_customizedboolean非必填是否使用个性化推荐,true 表示使用,false 表示不使用,默认 true。
with_couponboolean非必填是否只返回优惠券的商品,false 返回所有商品,true 只返回有优惠券的商品