返回字段参考:https://www.ecapi.cn/index/index/openapi/id/259.shtml?ptype=3
参数 | 类型 | 请求参数参考值 | 是否必须 | 说明 |
apkey | String | xxxxxxx | 是 | 用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)(*必要) |
channel_type | Number | 1 | 进宝频道推广商品: 1-今日销量榜,3-相似商品推荐,4-猜你喜欢(和进宝网站精选一致),5-实时热销榜,6-实时收益榜。默认值5 | |
custom_parameters | String | {"uid":"11111","sid":"22222&q | 自定义参数,为链接打上自定义标签;自定义参数最长限制64个字节;格式为: {"uid":"11111","sid":"22222"} ,其中 uid 用户唯一标识,可自行加密后传入,每个用户仅且对应一个标识,必填; sid 上下文信息标识,例如sessionId等,非必填。该json字符串中也可以加入其他自定义的key | |
limit | Number | 50 | 请求数量;默认值 : 50 | |
list_id | String | 翻页时建议填写前页返回的list_id值 | ||
offset | String | 从多少位置开始请求;默认值 : 0,offset需是limit的整数倍,仅支持整页翻页 | ||
pid | String | 推广位id | ||
cat_id | Number | 20100 | 猜你喜欢场景的商品类目,20100-百货,20200-母婴,20300-食品,20400-女装,20500-电器,20600-鞋包,20700-内衣,20800-美妆,20900-男装,21000-水果,21100-家纺,21200-文具,21300-运动,21400-虚拟,21500-汽车,21600-家装,21700-家具,21800-医药; | |
activity_tags | Number | 活动商品标记数组,例:[4,7],4-秒杀,7-百亿补贴,10851-千万补贴,11879-千万神券,10913-招商礼金商品,31-品牌黑标,10564-精选爆品-官方直推爆款,10584-精选爆品-团长推荐,24-品牌高佣,其他的值请忽略 | ||
goods_img_type | Number | 0 | 商品主图类型:1-场景图,2-白底图,默认为0 | |
goods_sign_list | String | 商品goodsSign列表,相似商品推荐场景时必传,仅取数组的第一位,例如:["c9r2omogKFFAc7WBwvbZU1ikIb16_J3CTa8HNN"]。goodsSign是加密后的goodsId, goodsId已下线,请使用goodsSign来替代。使用说明:https://jinbao.pinduoduo.com/qa-system?questionId=252 | ||
pdname | String | 是 | 在本平台授权的拼多多用户名 |
返回参数 | 类型 | 参数说明 | 扩展说明 |
list | Json | 返回数据列表 | |
total | Number | 总数量 | |
search_id | String | 搜索id,建议生成推广链接时候填写,提高收益。 | |
list_id | String | 翻页时必填前页返回的list_id值 |
{"code":200,"data":{"list":[{"coupon_remain_quantity":0,"promotion_rate":1,"cat_ids":[6536,7520,7523],"coupon_min_order_amount":0,"mall_id":970068671,"mall_name":"农夫山泉官方旗舰店","coupon_total_quantity":0,"merchant_type":"3","lgst_txt":"高","goods_name":"农夫山泉 NFC新疆苹果汁300mlx10瓶果汁饮料","sales_tip":"1.6万","goods_id":158588255983,"desc_txt":"高","goods_desc":"农夫山泉 NFC新疆苹果汁300mlx10瓶果汁饮料","opt_name":"食品","goods_thumbnail_url":"https://img.pddpic.com/oms_img/2020-08-09/738db62c881c52a03665004c676c6a8b.jpeg","opt_id":"1","opt_ids":[1,10724,230,8584,10696,11816,8585,8586,683,10700,12,6541,22926,11120,10038,22934,9975,8569,11833,8570,8571,219,22939,9982],"search_id":"435c11e97580149cba97b886ee64816682a","goods_image_url":"https://img.pddpic.com/oms_img/2020-08-09/116767a1-63e5-4d06-a738-32af78807e30.jpeg","has_coupon":false,"min_normal_price":7500,"serv_txt":"高","coupon_start_time":0,"min_group_price":6990,"coupon_discount":0,"coupon_end_time":0}],"total":2545,"request_id":"15970249023569971","search_id":"435c11e97580149cba97b886ee64816682a","list_id":"arwen_1755220_e38a3b42f59caf6dc2ba129c48576c76"},"msg":"success"}
code/http_status | 说明 |
200 | 数据获取成功 |
-1 | 数据获取失败 |
401 | IP没有添加白名单 |
429 | 访问次数超限 |
403 | 关键参数丢失 |
405 | 请求方式不对 |