拼多多API使用须知

多多进宝设置

蚂蚁星球推出开放API的目的在于,让具有开发能力的个人京东客,开发团队以及软件开发商更便捷的采集蚂蚁星球商品库的数据,实现优质好单的资源共享。使用蚂蚁星球开放API需要先申请apikey,您可以在本页面上方点击申请按钮或直接进入个人中心开放API页面申请,单个蚂蚁星球账号只能申请一个apikey。蚂蚁星球开放API是免费使用的,但蚂蚁星球保留对各接口进行调整的权利,我们会在调整时及时给予通知,也请您持续关注我们的公告。

联系技术支持:712218340 点击链接加入群聊【官方API交流群】(验证语:蚂蚁星球开放平台)

  • 商品列表
  • 商品详情
  • 分类列表
  • 标签列表
  • 转链API(支持备案)
  • 绑定备案查询
  • 订单查询
  • 多多进宝主题列表
  • 多多进宝主题商品
  • 运营频道商品
  • 主站频道推广接口
  • 营销工具推广(支持备案)
    • 详情
    • 错误参照代码
    • 接口地址: http://api-gw.haojingke.com/index.php/v1/api/pdd/goodslist

      支持格式: json

      请求方式: get/post

      请求示例: http://api-gw.haojingke.com/index.php/v1/api/pdd/goodslist?apikey=您的apikey&page=1&page_size=20

      请求参数说明:

      名称 类型 必填 说明
      apikey String 蚂蚁星球apikey,请将示例中的key替换成您的key
      page int 第几页(默认第1页)
      page_size int 1-100 默认20
      cat_id string 商品类目ID
      opt_id string 商品标签类目ID
      block_cats string 自定义屏蔽一级/二级/三级类目ID:多个用英文逗号分隔屏 自定义数量不超过20个;使用pdd.goods.cats.get接口获取cat_id
      block_cat_packages string 蔽商品类目包:多个用英文逗号分隔屏 1-拼多多小程序屏蔽的类目&关键词;2-虚拟类目;3-医疗器械;4-处方药;5-非处方药
      keyword string 关键字,支持goods_id、拼多多长链、进宝长链搜索
      goods_sign string 商品goodsSign,支持通过goods_sign查询商品
      sort_type string 排序方式: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-服务评分击败同类店铺百分比降序
      with_coupon string 是否只返回优惠券的商品,0返回所有商品,1只返回有优惠券的商品
      minpgpirce string 最小拼购金额
      maxpgpirce string 最大拼购金额
      minprice string 最小金额
      maxprice string 最大金额
      mincommission string 最小佣金比例
      maxcommission string 最大佣金比例
      mindiscount string 最小优惠券金额
      maxdiscount string 最大优惠券金额
      mincommissionshare string 最小佣金比例
      maxcommissionshare string 最大佣金比例
      minsale string 最小销量
      maxsale string 最大销量
      ispg string 是否拼购 1拼购
      merchant_type int 调用拼多多超级搜索(isunion=1)才有效 店铺类型,1-个人,2-企业,3-旗舰店,4-专卖店,5-专营店,6-普通店(未传为全部)
      isunion string isunion=1 表示返回拼多多原接口数据不做处理 返回值参考 官方文档
      pid string 拼多多官方推广位,不传使用开发者中心多多进宝设置的默认pid
      custom_parameters string 自定义参数,为链接打上自定义标签;自定义参数最长限制64个字节;格式为: {"uid":"11111","sid":"22222"} ,其中 uid 用户唯一标识,可自行加密后传入,每个用户仅且对应一个标识,必填; sid 上下文信息标识 ,例如sessionId等,非必填。该json字符串中也可以加入其他自定义的key
      predict_promotion string predict_promotion=1 表示返回比价参数predict_promotion_rate

      JSON返回示例:

      {
          "data": {
              "goods_list": [
                  {
              "goods_id": 8344870257,商品id 
              "goods_name": "12卷40卷48卷卫生纸批发家用卷纸巾竹浆厕纸妇婴纸手纸无芯卷筒",商品名称 
              "goods_short_name": "12卷40卷48卷卫生纸批发家用卷纸巾竹浆厕纸妇婴纸手纸无芯卷筒",短标题 
              "materiaurl": "http://mobile.yangkeduo.com/goods2.html?goods_id=8344870257",商品原链接 
              "goods_desc": "【您使用的纸巾够安全么?】我们生活,离不开空气和水源,在生活用品中,纸的使用也是占了生活的大部分。【买纸您是看手感?还是看掉不掉渣?还是看遇水易烂?】我们购买卫生纸,全家适用,尤其是家里有孩子和老人,更是要好好选择。【原谅当然是重中之重】纸巾很难在手感上面辨别纸巾是否安全和卫生。【恒曼品牌,达亿旗下电商新商标,与达意百慧是共同成长的品牌,多年的老品牌,线下千万顾客认证的纸品牌】采用进口原生竹浆,签署厂前供货合同,货源稳定可靠,品质保证。【喷浆精制,不爱掉渣,不添加任何荧光剂等有害物质】您买的放心,用的安心。是达亿纸业有限公司一直以来的追求和努力。【同等价格比品质,比质量,比价格,恒曼性价比高】",导购信息 
              "price": 11.9,原价 
              "price_pg": 9.9,拼购价(拼购商品才有) 
              "price_after": 6.9,券后价
              "discount": 3,券金额 
              "quota": 3,满多少可用券 
              "picurl": "https://t00img.yangkeduo.com/goods/images/2019-06-10/193fccbb500cd2b81eb2ee5c2af8305d.jpeg",图片地址
              "picurls": [
                  "https://t00img.yangkeduo.com/goods/images/2019-06-05/3a4cc069-ac35-495d-a4ff-c449a7e661d6.jpg",
                  "https://t00img.yangkeduo.com/goods/images/2019-06-18/6a886c8c-d453-4463-b848-7b59857a36a6.jpg",
                  "https://t00img.yangkeduo.com/goods/images/2019-06-10/ae7ec705-9c05-481a-95df-37d8b6b72ecc.jpg",
                  "https://t00img.yangkeduo.com/goods/images/2019-06-10/315dd56c-a67b-4d5f-99ec-8a5219cf2df5.jpg",
                  "https://t00img.yangkeduo.com/goods/images/2019-06-06/8419936a-3f34-4e0d-985b-623cc4f6f87a.jpg",
                  "https://t00img.yangkeduo.com/goods/images/2019-06-10/6dbc6e47-1ee2-4e6c-b408-1084004a4adc.jpg",
                  "https://t00img.yangkeduo.com/goods/images/2019-06-10/04286c4a-5c34-49dc-beaf-993a1c1a7924.jpg",
                  "https://t00img.yangkeduo.com/goods/images/2019-06-06/1e31ac1e-7570-4e28-be9a-8dae69dbeed3.jpg",
                  "https://t00img.yangkeduo.com/goods/images/2019-07-07/9e7801f0-ac1e-4aa8-a4d0-4fb6d721a4c0.jpg",
                  "https://t00img.yangkeduo.com/goods/images/2019-07-07/fd1fd75f-ae05-4977-a67f-d565bf0d5308.jpg"
              ],多图
              "sales": "8.9万",销量
              "start_time": 1562428800,推广开始时间
              "end_time": 1562601599,推广结束时间
              "pf_cid": 8590,分类id
              "pf_cname": "百货",分类名称
              "pdd_c_info": "a:3:{i:0;i:17285;i:1;i:17297;i:2;i:17402;}",
              "ispg": 1,是否拼购 0否1是
              "opt_id": 8590,标签ID
              "opt_name": "百货",标签名称
              "comments": 20899,	评论数量
              "goodcommentsshare": 4.71,	商品评价分
              "commission": 1.449,	预估佣金
              "commissionshare": 21,	佣金比例
              "shopid": 226035612,	店铺ID
              "shopname": "恒曼居家日用官方旗舰店",	店铺名称
              "has_mall_coupon": 0,,是否有店铺券 0否1是
              "mall_coupon_discount_pct": 0,	店铺折扣
              "mall_coupon_min_order_amount": 0,	最小使用金额
              "mall_coupon_max_discount_amount": 0,	最大使用金额
              "mall_coupon_total_quantity": 0,	店铺券总量
              "mall_coupon_remain_quantity": 0,	店铺券余量
              "mall_coupon_start_time": 0,	店铺券使用开始时间
              "mall_coupon_end_time": 0,	店铺券使用结束时间
              "avg_desc": 479,	描述评分
              "avg_lgst": 479,	物流评分
              "avg_serv": 479,	服务评分
              "desc_pct": 0.8267,	描述分击败同类店铺百分比
              "lgst_pct": 0.8398,	物流分击败同类店铺百分比
              "serv_pct": 0.849,	服务分击败同类店铺百分比
              "predict_promotion_rate": 200,	比价行为预判定佣金,需要用户备案
                  }
              ],
              "totalCount": 50总数 
          },
          "message": "success",提示信息 
          "status_code": 200状态码 200表示请求成功 
      }
      
      }
      										
    • status_code=200 成功,其他失败,具体信息见message返回值