如接口返回此提示:{"code":-1,"data":{"error_response":{"error_msg":"业务服务错误","sub_msg":"关键词搜索, 授权备案参数(pid,parameter)必填, 备案详情:https://jinbao.pinduoduo.com/qa-system?questionId=204,如有问题联系ddjb@pinduoduo.com","sub_code":"60001","error_code":50001,"request_id":"16063615390895523"}},"msg":"业务服务错误"}
解决方法参考:http://dev.21ds.cn/article/546.html
参数 | 类型 | 请求参数参考值 | 是否必须 | 说明 |
apkey | String | xxxxxxx | 是 | 用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)(*必要) |
optid | Number | 1 | 商品标签类目ID,可通过:http://openapi.weimohe.cn/index/index/openapi/id/60.shtml?ptype=3 获取 | |
keyword | String | 衣服 | 商品关键词,与opt_id字段选填一个或全部填写,不支持纯数字(goods_id)搜索 | |
page | Number | 1 | 是 | 页码 |
pagesize | Number | 100 | 是 | 每页数据多少条,10~100 |
coupon | String | true | 是 | 是否只返含有优惠券的商品,true,是,false,否 |
sort | Number | 1 | 是 | 排序; 排序方式: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-服务评分击败同类店铺百分比降序 |
range_list | String | [{"range_id":0,"range_from":1,"range_to | 范围列表,可选值:[{"range_id":0,"range_from":1,"range_to":1500},{"range_id":1,"range_from":1,"range_to":1500}] | |
cat_id | Number | 商品类目ID,使用pdd.goods.cats.get接口获取 | ||
goods_id_list | String | 3103875972,4710158125 | 已经废弃,不再支持该功能 | |
zs_duo_id | Number | 招商多多客ID | ||
merchant_type | Number | 3 | 店铺类型,1-个人,2-企业,3-旗舰店,4-专卖店,5-专营店,6-普通店(未传为全部) | |
pid | String | 推广位id | ||
custom_parameters | String | 自定义参数 | ||
activity_tags | String | 商品活动标记数组,例:[4,7],4-秒杀 7-百亿补贴等 | ||
is_brand_goods | String | 是否为品牌商品 | ||
list_id | String | 翻页时建议填写前页返回的list_id值 |
返回参数 | 类型 | 参数说明 | 扩展说明 |
total_count | Number | 搜索到符合条件的结果总数 | |
list | Json | 商品列表 | |
├ mall_cps | Number | 该商品所在店铺是否参与全店推广,0:否,1:是 | |
├ category_name | String | 商品类目名 | |
├ category_id | String | 商品类目ID | |
├ opt_ids | String | 商品标签ID | |
├ merchant_type | Number | 店铺类型 | 1-个人,2-企业,3-旗舰店,4-专卖店,5-专营店,6-普通店 |
├ serv_txt | String | 服务评分 | |
├ lgst_txt | String | 物流评分 | |
├ desc_txt | String | 描述评分 | |
├ goods_gallery_urls | String | 商品详情图列表 | |
├ opt_name | String | 商品标签名 | |
├ opt_id | String | 商品标签ID | 格式为:[一级标签ID,二级标签ID,三级标签ID...]使用getpddgoodsopt获取 |
├ cat_ids | String | 商品类目ID | 使用getpddgoodscats接口获取 |
├ goods_eval_count | Number | 商品评价数量 | |
├ goods_desc | String | 商品描述 | |
├ promotion_rate | String | 佣金比例 | 千分比 |
├ coupon_end_time | String | 优惠券失效时间 | |
├ coupon_start_time | String | 优惠券生效时间 | |
├ coupon_remain_quantity | Number | 优惠券剩余数量 | |
├ coupon_total_quantity | Number | 优惠券总数量 | |
├ coupon_discount | String | 优惠券面额 | 单位:分 |
├ coupon_min_order_amount | String | 优惠券门槛价格 | 单位:分 |
├ mall_name | String | 店铺名称 | |
├ min_normal_price | String | 最小单买价格 | 单位:分 |
├ min_group_price | String | 最小拼团价格 | |
├ sales_tip | Number | 已售卖件数 | |
├ goods_image_url | String | 商品主图 | |
├ goods_thumbnail_url | String | 商品缩略图 | |
├ goods_name | String | 商品标题 | |
├ goods_id | String | 参与多多进宝的商品ID | |
├ has_mall_coupon | String | 是否有店铺券 | |
├ mall_coupon_id | String | 店铺券id | |
├ mall_coupon_discount_pct | String | 店铺券折扣 | |
├ mall_coupon_min_order_amount | String | 最小使用金额 | |
├ mall_coupon_max_discount_amount | String | 最大使用金额 | |
├ mall_coupon_total_quantity | Number | 店铺券总量 | |
├ mall_coupon_remain_quantity | String | 店铺券余量 | |
├ mall_coupon_start_time | String | 店铺券开始使用时间 | |
├ mall_coupon_end_time | String | 店铺券结束使用时间 | |
├ create_at | Number | 创建时间(unix时间戳) | |
├ has_coupon | String | 商品是否有优惠券 true-有,false-没有 | |
├ activity_type | String | 活动类型 | 0-无活动;1-秒杀;3-限量折扣;12-限时折扣;13-大促活动;14-名品折扣;15-品牌清仓;16-食品超市;17-一元幸运团;18-爱逛街;19-时尚穿搭;20-男人帮;21-9块9;22-竞价活动;23-榜单活动;24-幸运半价购;25-定金预售;26-幸运人气购;27-特色主题活动;28-断码清仓;29-一元话费;30-电器城;31-每日好店;32-品牌卡;101-大促搜索池;102-大促品类分会场; |
├ service_tags | String | 服务标签 | 4-送货入户并安装,5-送货入户,6-电子发票,9-坏果包赔,11-闪电退款,12-24小时发货,13-48小时发货,17-顺丰包邮,18-只换不修,19-全国联保,20-分期付款,24-极速退款,25-品质保障,26-缺重包退,27-当日发货,28-可定制化,29-预约配送,1000001-正品发票,1000002-送货入户并安装 |
├ clt_cpn_batch_sn | String | 店铺收藏券id | |
├ clt_cpn_start_time | String | 店铺收藏券起始时间 | |
├ clt_cpn_end_time | String | 店铺收藏券截止时间 | |
├ clt_cpn_quantity | String | 店铺收藏券总量 | |
├ clt_cpn_remain_quantity | String | 店铺收藏券剩余量 | |
├ clt_cpn_discount | String | 店铺收藏券面额,单位为分 | |
├ clt_cpn_min_amt | String | 店铺收藏券使用门槛价格,单位为分 | |
├ plan_type | String | 推广计划类型 3:定向 4:招商 | |
├ zs_duo_id | String | 招商团长id | |
├ activity_tags | String | 商品活动标记数组,例:[4,7],4-秒杀 7-百亿补贴等 | |
├ predict_promotion_rate | String | 比价行为预判定佣金,需要用户备案 | |
├ share_rate | String | 招商分成服务费比例,千分比 | |
├ unified_tags | Json | 优惠标签列表 | |
├ goods_sign | String | 商品goodsSign | |
list_id | String | 翻页时必填前页返回的list_id值 | |
search_id | String | 搜索id,建议生成推广链接时候填写,提高收益 |
{"code":200,"data":{"goods_list":[{"create_at":1530885033,"goods_id":2069404750,"goods_name":"【满50减5】内蒙南瓜子500g 新货现炒椒盐生熟原味五香散装","goods_desc":null,"goods_thumbnail_url":"http://t00img.yangkeduo.com/goods/images/2018-08-24/04cc643fa272b846e56616670d49752b.jpeg","goods_image_url":"http://t00img.yangkeduo.com/t03img/images/2018-07-04/0db3735d073263a44bc0a81a7f1a3063.jpeg","goods_gallery_urls":null,"sold_quantity":15,"min_group_price":750,"min_normal_price":850,"mall_name":"悠然干果店","merchant_type":1,"category_id":1,"category_name":"美食","opt_id":1,"opt_name":"美食","opt_ids":[96,1,228,101,219,12,2749,2751],"cat_ids":[6398,6399,6408,0],"mall_cps":0,"has_coupon":false,"coupon_min_order_amount":0,"coupon_discount":0,"coupon_total_quantity":null,"coupon_remain_quantity":null,"coupon_start_time":null,"coupon_end_time":null,"promotion_rate":0,"goods_eval_score":0,"goods_eval_count":0,"cat_id":null,"avg_desc":476,"avg_lgst":480,"avg_serv":479,"desc_pct":0.3787,"lgst_pct":0.6829,"serv_pct":0.6348},{"create_at":1533937917,"goods_id":1708387236,"goods_name":"政融集团吴博士益生菌固体饮料 肠胃肠道益生菌 依江春生命活菌","goods_desc":null,"goods_thumbnail_url":"http://t00img.yangkeduo.com/goods/images/2018-09-01/e4c91d28919fe93b7c57d90a45635c93.jpeg","goods_image_url":"","goods_gallery_urls":null,"sold_quantity":0,"min_group_price":40500,"min_normal_price":40800,"mall_name":"健康屋养生馆","merchant_type":1,"category_id":1,"category_name":"美食","opt_id":1,"opt_name":"美食","opt_ids":[1,227,100,219,1835,12,221,95],"cat_ids":[6785,6817,6822,0],"mall_cps":0,"has_coupon":false,"coupon_min_order_amount":0,"coupon_discount":0,"coupon_total_quantity":null,"coupon_remain_quantity":null,"coupon_start_time":null,"coupon_end_time":null,"promotion_rate":1,"goods_eval_score":null,"goods_eval_count":0,"cat_id":null,"avg_desc":0,"avg_lgst":0,"avg_serv":0,"desc_pct":null,"lgst_pct":null,"serv_pct":null}],"total_count":150706},"msg":"商品获取成功"}
code/http_status | 说明 |
200 | 数据获取成功 |
-1 | 数据获取失败 |
401 | IP没有添加白名单 |
429 | 访问次数超限 |
403 | 关键参数丢失 |
405 | 请求方式不对 |